3.2.4.10 R_DhcpCreateMClientInfo (Opnum 9)
The R_DhcpCreateMClientInfo method creates a multicast client record on the MADCAP server's database. This also marks the specified client IP address as unavailable (or distributed).
-
DWORD R_DhcpCreateMClientInfo( [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress, [in, ref, string] LPWSTR* MScopeName, [in, ref] LPDHCP_MCLIENT_INFO ClientInfo );
ServerIpAddress: The IP address/host name of the MADCAP server. This parameter is unused.
MScopeName: This is a pointer to a Unicode string that contains the name of the multicast subnet MADCAP client that needs to be created.
ClientInfo: This is a pointer of type LPDHCP_MCLIENT_INFO (section 2.2.1.2.21), containing the complete information of the MADCAP client.
Return Values: A 32-bit unsigned integer value that indicates return status. A return value ERROR_SUCCESS (0x00000000) indicates that the operation was completed successfully, else it 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.
-
Return value/code
Description
0x00000000
ERROR_SUCCESS
This call was successful.
0x00000078
ERROR_CALL_NOT_IMPLEMENTED
The method is not implemented by this version of the MADCAP server.
The opnum field value for this method is 9.
When processing this call, the MADCAP server MUST do the following:
Return ERROR_CALL_NOT_IMPLEMENTED.
Exceptions Thrown: No exceptions SHOULD be thrown beyond those thrown by the underlying RPC protocol specified in [MS-RPCE].