Funzione PxeDhcpv6ParseRelayForw (wdspxe.h)

Questa funzione può essere usata da un provider per analizzare i messaggi RELAY-FORW e i messaggi annidati OPTION_RELAY_MSG. Le informazioni restituite possono essere usate per costruire un pacchetto RELAY-REPL usando la funzione PxeDhcpv6CreateRelayRepl .

Per altre informazioni sui messaggi RELAY-FORW e OPTION_RELAY_MSG, gli sviluppatori devono fare riferimento al protocollo di configurazione host dinamico per IPv6 (RFC 3315) gestito da Internet Engineering Task Force (IETF).

Sintassi

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
);

Parametri

[in] pRelayForwPacket

Specifica un puntatore a un messaggio DHCPv6 RELAY-FORW.

[in] uRelayForwPacketLen

Dimensioni in byte del messaggio RELAY-FORW a cui fa riferimento il parametro pRelayForwPacket .

[out] pRelayMessages

Matrice di strutture PXE_DHCPV6_NESTED_RELAY_MESSAGE inizializzate da questa routine. Le dimensioni della matrice sono specificate da nRelayMessages. Gli elementi di questa matrice vengono inizializzati per puntare alla catena annidata di pacchetti di inoltro codificati in OPTION_RELAY_MSG. Indice 0 è il pacchetto di OPTION_RELAY_MSG annidato più esterno. Poiché l'indice aumenta i puntatori corrispondono a pacchetti OPTION_RELAY_MSG annidati più profondamente.

[in] nRelayMessages

Dimensioni della matrice, in numero di elementi della matrice, a cui punta il parametro pRelayMessages .

[out] pnRelayMessages

Specifica un puntatore a un valore ULONG che in caso di esito positivo riceve il numero effettivo di elementi scritti nella matrice pRelayMessages .

[out] ppInnerPacket

Specifica un puntatore a un valore PVOID impostato sull'inizio del pacchetto più interno della catena di inoltro. Si tratta del pacchetto di richiesta client originale.

[out] pcbInnerPacket

Specifica un puntatore a un valore ULONG che in caso di esito positivo verrà impostato sulle dimensioni, in byte, del pacchetto più interno della catena di inoltro che è il pacchetto di richiesta client originale.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdspxe.h
Libreria	WdsPxe.lib
DLL	WdsPxe.dll