Dhcpv6RenewPrefix 函式 (dhcpv6csdk.h)

  • 發行項

Dhcpv6RenewPrefix 函式會更新先前使用Dhcpv6RequestPrefix函式取得的前置詞。

語法

DWORD Dhcpv6RenewPrefix(
  [in]      LPWSTR                         adapterName,
  [in]      LPDHCPV6CAPI_CLASSID           pclassId,
  [in, out] LPDHCPV6PrefixLeaseInformation prefixleaseInfo,
  [out]     DWORD                          *pdwTimeToWait,
  [in]      DWORD                          bValidatePrefix
);

參數

[in] adapterName

必須傳送前置詞更新的介面卡 GUID。

[in] pclassId

DHCPV6CAPI_CLASSID結構的指標，其中包含要傳送于線上的二進位 ClassId 資訊。 此參數可以是 Null。

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

[in, out] prefixleaseInfo

DHCPV6PrefixLeaseInformation結構的指標，其中包含前置詞租用資訊。

[out] pdwTimeToWait

包含要求應用程式在呼叫 Dhcpv6RenewPrefix 函式以更新其取得前置詞之前必須等候的秒數。 0xFFFFFFFF值表示應用程式不需要更新其租用。

[in] bValidatePrefix

指定 DHCPv6 用戶端是否要傳送 REBIND，以驗證前置詞系結。 TRUE 表示需要 REBIND。 FALSE 表示需要 RENEW。

傳回值

成功完成時傳回ERROR_SUCCESS。

傳回碼 描述
ERROR_INVALID_PARAMETER
 如果下列其中一個條件成立，則傳回 ：
  • AdapterName 為 Null。 或者，找不到指定 GUID 的配接器。
  • prefixleaseInfo 為 Null。
  • pdwTimeToWait 為 Null。
ERROR_MORE_DATA
 如果 API 回應的前置詞比配置記憶體還多，則傳回 。
ERROR_INVALID_NAME
 AdapterName的格式不正確。 其格式應為： {00000000-0000-0000-0000-000000000000} 。

需求

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