3.2.4.68 R_DhcpSetSubnetInfoV6 (Opnum 67)
The R_DhcpSetSubnetInfoV6 method sets/modifies the information for an IPv6 prefix defined on the DHCPv6 server.
-
DWORD R_DhcpSetSubnetInfoV6( [in, unique, string] DHCP_SRV_HANDLE ServerIpAddress, [in] DHCP_IPV6_ADDRESS SubnetAddress, [in, ref] LPDHCP_SUBNET_INFO_V6 SubnetInfo );
ServerIpAddress: The IP address/host name of the DHCP server. This parameter is unused.
SubnetAddress: This is of the type DHCP_IPV6_ADDRESS, containing the IPv6 prefix ID for which the subnet information is modified.
SubnetInfo: This is a pointer to structure DHCP_SUBNET_INFO_V6 (section 2.2.1.2.56) that contains information of the IPv6 prefix that is modified in the existing IPv6 prefix identified by SubnetAddress.
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
The call was successful.
0x00004E25
ERROR_DHCP_SUBNET_NOT_PRESENT
The specified IPv6 prefix does not exist.
0x00004E2D
ERROR_DHCP_JET_ERROR
An error occurred while accessing the DHCP server database.
The opnum field value for this method is 67.
When processing this call, the DHCP server MUST do the following:
Validate if this method is authorized for read/write access per section 3.5.5. If not, return the error ERROR_ACCESS_DENIED.
If the SubnetInfo input parameter is NULL, return ERROR_INVALID_PARAMETER.
Retrieve the DHCPv6Scope object from DHDPv6ScopeList that has a SubnetAddress field of SubnetInfoV6 equal to the SubnetAddress passed in as a parameter to the current API.
If the DHCPv6Scope object corresponding to SubnetAddress is not found, return ERROR_DHCP_SUBNET_NOT_PRESENT.
Modify the DHCPv6Scope object information from SubnetInfo in DHCPv6ScopeList.
Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].