Share via

3.2.4.132 R_DhcpV4CreateClientInfoEx (Opnum 131)

  • Article

The R_DhcpV4CreateClientInfoEx method creates a DHCPv4 client lease record on the DHCP server.

The R_DhcpV4CreateClientInfoEx method is an extension of the R_DhcpV4CreateClientInfo (Opnum 122) (section 3.2.4.132) method, where a DHCP_CLIENT_INFO_EX (section 2.2.1.2.119) structure is specified, rather than a DHCP_CLIENT_INFO_PB (section 2.2.1.2.119) structure. The structure contains a list of DHCP_PROPERTY (section 2.2.1.2.117) elements that can be associated with the given DHCPv4 client.

 DWORD R_DhcpV4CreateClientInfoEx(
   [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress,
   [in, ref] LPDHCP_CLIENT_INFO_EX ClientInfo
 );

ServerIpAddress: As specified in R_DhcpV4CreateClientInfo (Opnum 122).

ClientInfo: A pointer to a DHCP_CLIENT_INFO_EX structure that contains the DHCPv4 client lease record information to be set on the DHCPv4 server. The caller MUST pass the ClientIPAddress and ClientHardwareAddress members when adding a DHCPv4 client lease record to the DHCPv4 server. The ClientHardwareAddress member represents a DHCPv4 client-identifier as specified in section 2.2.1.2.5.1. The ClientName, ClientComment, ClientLeaseExpires, bClientType, AddressState, Status, ProbationEnds, QuarantineCapable, PolicyName, and OwnerHost members are modified on the DHCPv4 client lease record identified by the ClientIpAddress member. <89>

The DHCP_PROPERTY elements that are supported are as follows:

AddressStateEx: The DHCP_PROPERTY element specifies the extended address state flags for the client when the ID value is DhcpPropIdClientAddressStateEx and the Type value is DhcpPropTypeDword.

The opnum field value for this method is 131.

The remainder of the processing behavior for this method is as defined for the R_DhcpV4CreateClientInfo method.