Función Dhcpv6RequestParams (dhcpv6csdk.h)

  • Artículo

La función Dhcpv6RequestParams solicita opciones desde la memoria caché del cliente DHCPv6 o directamente desde el servidor DHCPv6.

Sintaxis

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

Parámetros

forceNewInform

Si este valor se establece en TRUE, se omitirá cualquier información almacenada en caché disponible y se solicitará nueva información. De lo contrario, la solicitud solo se envía si no hay información almacenada en caché.

reserved

Reservado para uso futuro. Debe establecerse en NULL.

adapterName

GUID del adaptador para el que está pensada esta solicitud. Este parámetro no debe ser NULL.

classId

Puntero a una estructura de DHCPV6CAPI_CLASSID que contiene la información de ClassId binaria que se va a usar para enviar en la conexión. Este parámetro es opcional.

recdParams

Estructura DHCPV6CAPI_PARAMS_ARRAY que contiene los parámetros que se van a recibir del servidor DHCPV6.

buffer

Un búfer que contiene información devuelta por algunos punteros en recdParams.

pSize

Tamaño del búfer. Cuando la función devuelve ERROR_MORE_DATA, este parámetro contendrá el tamaño, en bytes, necesario para completar la operación. Si la función se ejecuta correctamente, este parámetro contiene el número de bytes usados.

Valor devuelto

Devuelve ERROR_SUCCESS tras la finalización correcta.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Se devuelve si se cumple una de las siguientes condiciones:
  • reserved tiene un valor que no es NULL.
  • AdapterName es NULL. O no se encuentra ningún adaptador con el GUID especificado.
  • pSize es NULL.
  • el búfer es NULL.
ERROR_MORE_DATA
 La llamada a esta API se realizó con memoria insuficiente asignada para el parámetro Buffer , mientras que pSize contiene el tamaño de memoria real necesario.
ERROR_INVALID_NAME
 AdapterName no tiene el formato correcto. Debe tener este formato: {00000000-0000-0000-0000-000000000000}.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dhcpv6csdk.h
Library Dhcpcsvc6.lib
Archivo DLL Dhcpcsvc6.dll