Функция Dhcpv6RequestParams (dhcpv6csdk.h)

Статья
08/23/2023

Функция 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. buffer имеет значение NULL.
ERROR_MORE_DATA	Вызов этого API был выполнен с недостаточным объемом памяти, выделенной для параметра Buffer , в то время как pSize содержит фактический необходимый объем памяти.
ERROR_INVALID_NAME	Имя адаптера имеет неправильный формат. Он должен иметь следующий формат: {00000000-0000-0000-0000-000000000000}.

Требования


Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dhcpv6csdk.h
Библиотека	Dhcpcsvc6.lib
DLL	Dhcpcsvc6.dll

Поделиться через