3.1.4.22 R_DhcpGetClientOptions (Opnum 21)
The R_DhcpGetClientOptions method is never used.
-
DWORD R_DhcpGetClientOptions( [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress, [in] DHCP_IP_ADDRESS ClientIpAddress, [in] DHCP_IP_MASK ClientSubnetMask, [out] LPDHCP_OPTION_LIST* ClientOptions );
ServerIpAddress: The IP address/host name of the DHCP server. This parameter is unused.
ClientIpAddress: This is of type DHCP_IP_ADDRESS (section 2.2.1.2.1). Currently it is not used, and any value set to this parameter will not affect the behavior of this method.
ClientSubnetMask: This is of type DHCP_IP_MASK (section 2.2.1.2.2). Currently it is not used, and any value set to this parameter will not affect the behavior of this method.
ClientOptions: This is a pointer of type LPDHCP_OPTION_LIST. Currently it is not used, and any value set to this parameter will not affect the behavior of this method.
Return Values: A 32-bit unsigned integer value that indicates return status. A return value contains a Win32 error code, as specified in [MS-ERREF]. This error code value can correspond to a DHCP-specific failure, which takes a value between 20000 and 20099, or any generic failure.
The opnum field value for this method is 21.
When processing this call, the DHCP server MUST do the following:
Validate whether this method is authorized for read access per section 3.5.4. If not, return the error ERROR_ACCESS_DENIED.
If validation is successful, return ERROR_CALL_NOT_IMPLEMENTED to the caller.
Exceptions Thrown: No exceptions SHOULD be thrown beyond those thrown by the underlying RPC protocol specified in [MS-RPCE].