2.2.3.2.4 DNS_RPC_IP_VALIDATE

The DNS_RPC_IP_VALIDATE structure is used to request that the DNS server validate a number of IP addresses. This can be used by clients to determine if an IP address is suitable for use as a DNS server in the context specified by the dwContext member (see below). This structure is to request IP validation while processing the R_DnssrvComplexOperation2 (section 3.1.4.8) method call with operation type IpValidate.

 typedef struct _DnsRpcIPValidate {
   DWORD dwRpcStructureVersion;
   DWORD dwReserved0;
   DWORD dwContext;
   DWORD dwReserved1;
   [string] char* pszContextName;
   PDNS_ADDR_ARRAY aipValidateAddrs;
 } DNS_RPC_IP_VALIDATE,
  *PDNS_RPC_IP_VALIDATE;

dwRpcStructureVersion: The DNS management structure version number. This value MUST be set to 0x00000001.

dwReserved0: This field is unused. The client MUST set this value to zero and the server MUST ignore it.

dwContext: The context or purpose for which addresses present in aipValidateAddrs MUST be validated by the DNS server. This field MUST be set to one of the following values:

Value	Meaning
DNS_IPVAL_DNS_SERVERS 0x00000000	Validate that IP addresses are reachable and operational by the DNS servers.
DNS_IPVAL_DNS_ROOTHINTS 0x00000001	Validate that IP addresses are suitable as root hints.
DNS_IPVAL_DNS_FORWARDERS 0x00000002	Validate that IP addresses are server level forwarders.
DNS_IPVAL_DNS_ZONE_MASTERS 0x00000003	Validate that IP addresses are remote DNS servers hosting a zone, named as pointed to by pszContextName.
DNS_IPVAL_DNS_DELEGATIONS 0x00000004	Validate that IP addresses are remote DNS servers are name-server for the delegated zone, named as pointed to by pszContextName.

dwReserved1: This field is unused. The client MUST set this to zero and the server MUST ignore it.

pszContextName: A pointer to a null-terminated ASCII character string that specifies a zone name. The use of this zone name is specified by the dwContext member.

aipValidateAddrs: A pointer to a DNS_ADDR_ARRAY structure (section 2.2.3.2.3) contains a list of IP addresses to be validated by the DNS server.