Función PxeDhcpv6GetVendorOptionValue (wdspxe.h)

Recupera los valores de opción del campo OPTION_VENDOR_OPTS (17) de un paquete DHCPv6.

Sintaxis

DWORD PXEAPI PxeDhcpv6GetVendorOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            DWORD dwEnterpriseNumber,
  [in]            WORD  wOption,
  [in]            ULONG uInstance,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

Parámetros

[in] pPacket

Puntero a un paquete de respuesta asignado con la función PxePacketAllocate .

[in] uPacketLen

Longitud del paquete al que apunta el parámetro pReplyPacket .

[in] dwEnterpriseNumber

Número de empresa asignado al proveedor de la opción por la Entidad de números asignados a Internet (IANA).

Para obtener más información sobre los números de empresa asignados, los desarrolladores deben consultar el Protocolo de configuración dinámica de host para IPv6 (RFC 3315) mantenido por the Internet Engineering Task Force (IETF).

[in] wOption

Opción cuyo valor se recuperará.

[in] uInstance

Índice basado en uno que especifica la instancia del parámetro wOption que se va a recuperar.

[out, optional] pwOptionLen

Dirección de WORD que recibirá la longitud del valor de opción.

[out, optional] ppOptionValue

Dirección de PVOID que recibirá la dirección del valor de opción dentro del paquete.

Valor devuelto

Los valores devueltos comunes se enumeran en la tabla siguiente. Para todos los demás errores, se devuelve un código de error de Windows adecuado.

Código o valor devuelto	Descripción
ERROR_SUCCESS 0 (0x0)	Se encontró la opción y se devolvió un puntero al valor .
ERROR_FILE_NOT_FOUND 2 (0x2)	La opción no se encuentra.
ERROR_INVALID_DATA 13 (0xD)	El paquete no es un paquete DHCP válido. Esta prueba no es tan exhaustiva como las pruebas utilizadas por la función PxeDhcpv6IsValid ; solo se comprueba la longitud del paquete y la cookie mágica.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wdspxe.h
Library	WdsPxe.lib
Archivo DLL	WdsPxe.dll

Consulte también

PxeDhcpv6GetOptionValue

PxePacketAllocate

Funciones del servidor de Servicios de implementación de Windows