Use initial DC discovery retry setting for background callers
Jump to overview

Policy overview

Key metadata and intent for this policy.

Computer
Category
System > Net Logon
Supported on
At least Windows Server 2003 operating systems or Windows XP Professional

Supported OS tags: Windows10, Windows10RT, Windows11, Windows7, Windows8, Windows81, WindowsRT, WindowsRT81, WindowsServer2003, WindowsServer2008, WindowsServer2012, WindowsServer2012R2, WindowsServer2016, WindowsVista, WindowsXP

This policy setting determines the amount of time (in seconds) to wait before the first retry for applications that perform periodic searches for domain controllers (DC) that are unable to find a DC. The default value for this setting is 10 minutes (10*60). The maximum value for this setting is 49 days (0x49*24*60*60=4233600). The minimum value for this setting is 0. This setting is relevant only to those callers of DsGetDcName that have specified the DS_BACKGROUND_ONLY flag. If the value of this setting is less than the value specified in the NegativeCachePeriod subkey, the value in the NegativeCachePeriod subkey is used. Warning: If the value for this setting is too large, a client will not attempt to find any DCs that were initially unavailable. If the value set in this setting is very small and the DC is not available, the traffic caused by periodic DC discoveries may be excessive.

Internal name
Netlogon_BackgroundRetryInitialPeriod
Policy ID
3831e7f0d72a
Elements
1

Registry values

How enabled and disabled states update the registry.

No explicit registry values are set for enabled or disabled states.

Policy elements

Inputs and configuration options exposed by this policy.

ScopeElementTypeRegistry mappingConstraints & behaviorCopy
Computer
Seconds:
ID Netlogon_BackgroundRetryInitialPeriodLabel
decimal
Path
Software\Policies\Microsoft\Netlogon\Parameters
Value name
BackgroundRetryInitialPeriod
Type
REG_DWORD
Range: ? to 4233600
Seconds:
Computer · Type decimal
Registry mapping
Path
Software\Policies\Microsoft\Netlogon\Parameters
Value name
BackgroundRetryInitialPeriod
Type
REG_DWORD
Details
Range: ? to 4233600