2.2.4.2.2.2 DNS_RPC_SERVER_INFO_DOTNET

  • Article

In the DNS_RPC_SERVER_INFO_DOTNET structure all fields have same definition as specified in DNS_RPC_SERVER_INFO_W2K (section 2.2.4.2.2.1), with the following exceptions:<32>

 typedef struct _DnsRpcServerInfoDotNet {
   DWORD dwRpcStructureVersion;
   DWORD dwReserved0;
   DWORD dwVersion;
   UCHAR fBootMethod;
   BOOLEAN fAdminConfigured;
   BOOLEAN fAllowUpdate;
   BOOLEAN fDsAvailable;
   [string] char* pszServerName;
   [string] wchar_t* pszDsContainer;
   PIP4_ARRAY aipServerAddrs;
   PIP4_ARRAY aipListenAddrs;
   PIP4_ARRAY aipForwarders;
   PIP4_ARRAY aipLogFilter;
   [string] wchar_t* pwszLogFilePath;
   [string] char* pszDomainName;
   [string] char* pszForestName;
   [string] char* pszDomainDirectoryPartition;
   [string] char* pszForestDirectoryPartition;
   [string] char* pExtensions[6];
   DWORD dwLogLevel;
   DWORD dwDebugLevel;
   DWORD dwForwardTimeout;
   DWORD dwRpcProtocol;
   DWORD dwNameCheckFlag;
   DWORD cAddressAnswerLimit;
   DWORD dwRecursionRetry;
   DWORD dwRecursionTimeout;
   DWORD dwMaxCacheTtl;
   DWORD dwDsPollingInterval;
   DWORD dwLocalNetPriorityNetMask;
   DWORD dwScavengingInterval;
   DWORD dwDefaultRefreshInterval;
   DWORD dwDefaultNoRefreshInterval;
   DWORD dwLastScavengeTime;
   DWORD dwEventLogLevel;
   DWORD dwLogFileMaxSize;
   DWORD dwDsForestVersion;
   DWORD dwDsDomainVersion;
   DWORD dwDsDsaVersion;
   DWORD dwReserveArray[4];
   BOOLEAN fAutoReverseZones;
   BOOLEAN fAutoCacheUpdate;
   BOOLEAN fRecurseAfterForwarding;
   BOOLEAN fForwardDelegations;
   BOOLEAN fNoRecursion;
   BOOLEAN fSecureResponses;
   BOOLEAN fRoundRobin;
   BOOLEAN fLocalNetPriority;
   BOOLEAN fBindSecondaries;
   BOOLEAN fWriteAuthorityNs;
   BOOLEAN fStrictFileParsing;
   BOOLEAN fLooseWildcarding;
   BOOLEAN fDefaultAgingState;
   BOOLEAN fReserveArray[15];
 } DNS_RPC_SERVER_INFO_DOTNET,
  *PDNS_RPC_SERVER_INFO_DOTNET;

dwRpcStructureVersion: The DNS management structure version number. The following are possible values:

Value

Meaning

0x00000001

Structure is of type DNS_RPC_SERVER_INFO_DOTNET (section 2.2.4.2.2.2).

0x00000002

Structure is of type DNS_RPC_SERVER_INFO_LONGHORN (section 2.2.4.2.2.3).

dwReserved0: This field is reserved for future use. Senders MUST set this to zero and it MUST be ignored by receiver.

aipLogFilter: The list of IP addresses used for debug log filtering. The DNS server will log DNS traffic that is sent to or received from for these IP addresses and will not log DNS traffic to or from other IP addresses. If this value is set to NULL then the DNS server will not perform IP filtering when logging DNS traffic.

pwszLogFilePath: A pointer to a null-terminated Unicode string that contains an absolute pathname or relative pathname or filename for the operational log file on the DNS server. If this value is set to NULL, the log SHOULD be logged to an implementation specific log file.

pszDomainName: A pointer to a null-terminated UTF-8 string that contains the name of the directory server domain to which the DNS server belongs if directory server is available. This value will be NULL if no directory server is available.

pszForestName: A pointer to a null-terminated UTF-8 string that contains the name of the directory server forest to which the DNS server belongs if directory server is available. This value will be NULL if no directory server is available.

pszDomainDirectoryPartition: A pointer to a null-terminated UTF-8 string that contains the base name for the domain wide DNS application directory partition.

pszForestDirectoryPartition: A pointer to a null-terminated UTF-8 string that contains the base name for the forest-wide DNS application directory partition.

pExtensions: Reserved for future use. Senders MUST set this to NULL and it MUST be ignored by the receiver.

dwLocalNetPriorityNetMask: The net mask used by the DNS server to prioritize address records in responses when the server is configured to enforce LocalNetPriority as mentioned above.

dwLastScavengeTime: The timestamp at which the last scavenging cycle was executed on the DNS server. If this value is set to 0 then no scavenging cycle has been run since the server was last started.

dwEventLogLevel: This value indicates what level of events will be logged by the DNS server. This value MUST be set to one of the combination of the possible values for this defined in DNS_EVENTLOG_TYPES (section 2.2.9.1.2).

dwLogFileMaxSize: The maximum allowed size, in bytes, for the log file.

dwDsForestVersion: This value indicates the directory server forest version being used by the DNS server, stored in the ForceForestBehaviorVersion property.

dwDsDomainVersion: This value indicates the directory server domain version being used by the DNS server, stored in the ForceDomainBehaviorVersion property.

dwDsDsaVersion: This value indicates the directory server local server version being used by the DNS server, stored in the ForceDsaBehaviorVersion property.