Dhcpv6RequestPrefix 函式 (dhcpv6csdk.h)

Dhcpv6RequestPrefix 函式會要求特定的前置詞。

語法

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

參數

[in] adapterName

必須傳送前置詞要求的配接器 GUID。

[in] pclassId

DHCPV6CAPI_CLASSID 結構的指標，其中包含要傳送在在線的二進位 ClassId 資訊。 這是選擇性參數。

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

 

[in, out] prefixleaseInfo

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

DHCPV6PrefixLeaseInformation 結構的下列成員必須遵循這些指導方針。

DHCPV6PrefixLeaseInformation 成員	考量
nPrefixes	必須包含最大值 10。 呼叫端應該根據指定的前置詞數目，在 prefixArray 成員中配置記憶體。
iaid	指派給這個成員的唯一正數。 如果再次呼叫此函式，應該重複使用這個相同的值。呼叫端應用程式必須設定這個必要值。
ServerIdLen	必須包含最大值 128。 呼叫端必須根據指定的 ServerIdLen 值，在 ServerId 成員中配置記憶體。

 

呼叫端在指派 DHCPV6PrefixLeaseInformation 結構的 nPrefixes、iaid 和 ServerIdLen 成員時，必須遵循這些考慮。 根據這些值，在呼叫 Dhcpv6RequestPrefix 函式之前，記憶體也必須正確配置給 ServerId 和 PrefixArray 成員。

[out] pdwTimeToWait

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

傳回值

成功完成時傳回ERROR_SUCCESS。

傳回碼	Description
ERROR_MORE_DATA	指定的 nPrefixes 或 ServerIdLen 成員的值小於伺服器可用的前置詞數目或可用的伺服器標識符長度。 增加 nPrefixes 或 ServerIdLen 成員，並確定已正確配置對應的記憶體，然後再再次呼叫 Dhcpv6RequestPrefix 函式。
ERROR_INVALID_PARAMETER	如果下列其中一個條件成立，則會傳回 ： AdapterName 為 NULL。 或者找不到具有指定 GUID 的配接器。 prefixleaseInfo 為 NULL。 pdwTimeToWait 為 NULL。 prefixleaseInfo 的 iaid 成員為零。
ERROR_INVALID_NAME	AdapterName 的格式不正確。 其格式應為： {00000000-0000-0000-0000-000000000000}。

規格需求

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