dhcpv6RequestParams 函式 (dhcpv6csdk.h)

  • 發行項

Dhcpv6RequestParams 函式會從 DHCPv6 用戶端快取或直接從 DHCPv6 伺服器要求選項。

語法

DWORD Dhcpv6RequestParams(
  BOOL                    forceNewInform,
  LPVOID                  reserved,
  LPWSTR                  adapterName,
  LPDHCPV6CAPI_CLASSID    classId,
  DHCPV6CAPI_PARAMS_ARRAY recdParams,
  LPBYTE                  buffer,
  LPDWORD                 pSize
);

參數

forceNewInform

如果此值設定為 TRUE，則會忽略任何可用的快取資訊，並要求新資訊。 否則，只有在沒有快取的資訊時，才會傳送要求。

reserved

保留供未來使用。 必須設定為 Null。

adapterName

此要求所代表之介面卡的 GUID。 此參數不得為 Null。

classId

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

recdParams

DHCPV6CAPI_PARAMS_ARRAY結構，其中包含要從 DHCPV6 伺服器接收的參數。

buffer

緩衝區，包含 recdParams中某些指標傳回的資訊。

pSize

緩衝區的大小。 當函式傳回ERROR_MORE_DATA時，此參數會包含完成作業所需的大小，以位元組為單位。 如果函式成功，此參數會包含使用的位元組數目。

傳回值

成功完成時傳回ERROR_SUCCESS。

傳回碼 描述
ERROR_INVALID_PARAMETER
 如果下列其中一個條件成立，則傳回 ：
  • reserved 的值不是 Null。
  • AdapterName 為 Null。 或者，找不到指定 GUID 的配接器。
  • pSize 為 Null。
  • 緩衝區 為 Null。
ERROR_MORE_DATA
 呼叫此 API 時，已配置給 Buffer 參數的記憶體不足， 而 pSize 則包含所需的實際記憶體大小。
ERROR_INVALID_NAME
 AdapterName的格式不正確。 其格式應為： {00000000-0000-0000-0000-000000000000} 。

需求

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