3.5.4.3.1 SetDnsConfig Method (Opnum 3)

  • Article

The SetDnsConfig method updates the behavior of the Domain Name System (DNS) name resolution of the Network Adapters on the RRAS server. 

 HRESULT SetDnsConfig(
   [in] DWORD dwConfigId,
   [in] DWORD dwNewValue
 );

dwConfigId: This is of type DWORD and MUST be set to the following value.

Value

Meaning

0x00010011

Indicates to the DNS name resolution on the RRAS server to not wait for name resolution response from all the adapters.

dwNewValue: This is of type DWORD and MUST be set to 0.

Return Values: The server MUST return zero if it successfully processes the message. If processing fails, the server MUST return a nonzero HRESULT error code as defined in [MS-DTYP] section 2.2.18, between 0x80000000 and 0xFFFFFFFF, as specified in [MS-ERREF] section 2.1. For protocol purposes, all nonzero values MUST be treated as equivalent failures.

When processing this call, the RRASM server MUST do the following:

  • Call the abstract interface Invoke REMRAS method specifying the operation and the parameters to enable RRAS server to perform the required management task.

  • Return any error status the RRAS server returns. Otherwise return ERROR_SUCCESS.

No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].