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

包含要从 DHCPV6 服务器接收的参数 的 DHCPV6CAPI_PARAMS_ARRAY 结构。

buffer

包含 recdParams 中某些指针返回的信息的缓冲区。

pSize

缓冲区的大小。 当函数返回ERROR_MORE_DATA时，此参数将包含完成操作所需的大小（以字节为单位）。 如果函数成功，则此参数包含使用的字节数。

返回值

成功完成后返回ERROR_SUCCESS。

返回代码 说明
ERROR_INVALID_PARAMETER
 如果满足以下条件之一，则返回 ：
  • reserved 的值为非 NULL。
  • AdapterName 为 NULL。 或者找不到具有指定 GUID 的适配器。
  • pSize 为 NULL。
  • buffer 为 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
Library Dhcpcsvc6.lib
DLL Dhcpcsvc6.dll