Compartir a través de

Función PxeDhcpv6ParseRelayForw (wdspxe.h)

  • Artículo

Un proveedor puede usar esta función para analizar los mensajes RELAY-FORW y sus mensajes anidados OPTION_RELAY_MSG. La información devuelta se puede usar para construir un paquete RELAY-REPL mediante la función PxeDhcpv6CreateRelayRepl .

Para obtener más información sobre los mensajes RELAY-FORW y OPTION_RELAY_MSG, los desarrolladores deben consultar el Protocolo de configuración dinámica de host para IPv6 (RFC 3315) mantenido por el Grupo de tareas de ingeniería de Internet (IETF).

Sintaxis

DWORD PXEAPI PxeDhcpv6ParseRelayForw(
  [in]  PVOID                            pRelayForwPacket,
  [in]  ULONG                            uRelayForwPacketLen,
  [out] PPXE_DHCPV6_NESTED_RELAY_MESSAGE pRelayMessages,
  [in]  ULONG                            nRelayMessages,
  [out] PULONG                           pnRelayMessages,
  [out] PBYTE                            *ppInnerPacket,
  [out] PULONG                           pcbInnerPacket
);

Parámetros

[in] pRelayForwPacket

Especifica un puntero a un mensaje RELAY-FORW DHCPv6.

[in] uRelayForwPacketLen

Tamaño en bytes del mensaje RELAY-FORW al que apunta el parámetro pRelayForwPacket .

[out] pRelayMessages

Matriz de PXE_DHCPV6_NESTED_RELAY_MESSAGE estructuras inicializadas por esta rutina. El tamaño de la matriz se especifica mediante nRelayMessages. Los elementos de esta matriz se inicializan para apuntar a la cadena anidada de paquetes de retransmisión codificados en OPTION_RELAY_MSG. El índice 0 es el paquete de OPTION_RELAY_MSG anidado más externo. A medida que el índice aumenta los punteros corresponden a paquetes OPTION_RELAY_MSG anidados más profundamente.

[in] nRelayMessages

Tamaño de la matriz, en número de elementos de matriz, al que apunta el parámetro pRelayMessages .

[out] pnRelayMessages

Especifica un puntero a un valor de ULONG que, si se ejecuta correctamente, recibe el número real de elementos escritos en la matriz pRelayMessages .

[out] ppInnerPacket

Especifica un puntero a un valor PVOID que, si se ejecuta correctamente, se establece en el inicio del paquete más interno de la cadena de retransmisión. Este es el paquete de solicitud de cliente original.

[out] pcbInnerPacket

Especifica un puntero a un valor de ULONG que, si se ejecuta correctamente, se establecerá en el tamaño, en bytes, del paquete más interno de la cadena de retransmisión, que es el paquete de solicitud de cliente original.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.

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