Dhcpv6ReleasePrefix 函式 (dhcpv6csdk.h)

  • 發行項

Dhcpv6ReleasePrefix 函式會釋放先前使用 Dhcpv6RequestPrefix 函式取得的前置詞。

語法

DWORD Dhcpv6ReleasePrefix(
  [in] LPWSTR                         adapterName,
  [in] LPDHCPV6CAPI_CLASSID           classId,
  [in] LPDHCPV6PrefixLeaseInformation leaseInfo
);

參數

[in] adapterName

必須傳送 PD 要求之配接器的名稱。

[in] classId

DHCPV6CAPI_CLASSID 結構的指標，其中包含用來在線路上傳送的二進位 ClassId 資訊。

注意 此 API 不支援 DHCPv6 選項代碼 15 (0x000F) 。 一般而言，用戶端會使用 [用戶類別] 選項來識別它所代表的使用者或應用程式類型或類別。 伺服器會根據此選項中所識別的類別，選取用戶端的組態資訊。
 

[in] leaseInfo

DHCPV6CAPIPrefixLeaseInformation 結構的指標，用來釋放前置詞。

傳回值

成功完成時傳回ERROR_SUCCESS。

傳回碼 Description
ERROR_INVALID_PARAMETER
 如果下列其中一個條件成立，則會傳回 ：
  • AdapterName 為 NULL。 或者找不到具有指定 GUID 的配接器。
  • prefixleaseInfo 為 NULL。
ERROR_INVALID_NAME
 AdapterName 的格式不正確。 其格式應為： {00000000-0000-0000-0000-000000000000}。

備註

釋放因呼叫此函式而傳送的訊息，必須包含 prefixleaseInfo 參數中提供之 DHCPV6CAPIPrefixLeaseInformation 結構之 T1 和 T2 字段的下列值：

  • T1：前置詞的更新時間，以秒為單位指定為絕對時間值。
  • T2：前置詞的重新系結時間，以秒為單位指定為絕對時間值。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 dhcpv6csdk.h
程式庫 Dhcpcsvc6.lib
Dll Dhcpcsvc6.dll