Click to Rate and Give Feedback
MSDN
MSDN Library
Networking
Network Protocols
DHCP Client API
 Dhcpv6ReleasePrefix Function
Dhcpv6ReleasePrefix Function

The Dhcpv6ReleasePrefix function releases a prefix previously acquired with the Dhcpv6RequestPrefix function.

Syntax

C++
DWORD APIENTRY Dhcpv6RenewPrefix(
  __in  LPWSTR adapterName,
  __in  LPDHCPV6CAPI_CLASSID classId,
  __in  LPDHCPV6CAPIPrefixLeaseInformation prefixleaseInfo
);

Parameters

adapterName [in]

Name of the adapter on which the PD request must be sent.

classId [in]

Pointer to a DHCPV6CAPI_CLASSID structure that contains the binary ClassId information to use to send on the wire.

Note   DHCPv6 Option Code 15 (0x000F) is not supported by this API. Typically, the User Class option is used by a client to identify the type or category of user or application it represents. A server selects the configuration information for the client based on the classes identified in this option.

prefixleaseInfo [in]

Pointer to a DHCPV6CAPIPrefixLeaseInformation structure that is used to release the prefix.

Return Value

Returns ERROR_SUCCESS upon successful completion.

Return codeDescription
ERROR_INVALID_PARAMETER

Returned if one of the following conditions are true:

  • AdapterName is NULL.
  • prefixleaseInfo is NULL.

 

Remarks

Release messages sent as the result of the call to this function must contain the following values for the T1 and T2 fields of the DHCPV6CAPIPrefixLeaseInformation structure supplied in the prefixleaseInfo parameter:

  • T1: the renewal time for the prefix, in seconds specified as absolute time values.
  • T2: the rebind time of the prefix, in seconds specified as absolute time values.

Requirements

Minimum supported clientWindows Vista
Minimum supported serverWindows Server 2008
HeaderDhcpv6csdk.h
LibraryDhcpcsvc6.lib
DLLDhcpcsvc6.dll

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2010 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement
Page view tracker