PxeDhcpv6ParseRelayForw, fonction (wdspxe.h)

Cette fonction peut être utilisée par un fournisseur pour analyser les messages RELAY-FORW et leurs messages OPTION_RELAY_MSG imbriqués. Les informations retournées peuvent être utilisées pour construire un paquet RELAY-REPL à l’aide de la fonction PxeDhcpv6CreateRelayRepl .

Pour plus d’informations sur les messages RELAY-FORW et OPTION_RELAY_MSG, les développeurs doivent consulter le protocole RFC 3315 (Dynamic Host Configuration Protocol for IPv6) géré par l’Internet Engineering Task Force (IETF).

Syntaxe

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

Paramètres

[in] pRelayForwPacket

Spécifie un pointeur vers un message RELAY-FORW DHCPv6.

[in] uRelayForwPacketLen

Taille en octets du message RELAY-FORW pointé vers le paramètre pRelayForwPacket .

[out] pRelayMessages

Tableau de structures PXE_DHCPV6_NESTED_RELAY_MESSAGE initialisées par cette routine. La taille du tableau est spécifiée par nRelayMessages. Les éléments de ce tableau sont initialisés pour pointer vers la chaîne imbriquée de paquets de relais encodés en OPTION_RELAY_MSG. Index 0 est le paquet de OPTION_RELAY_MSG imbriqué le plus à l’extérieur. À mesure que l’index augmente, les pointeurs correspondent à des paquets OPTION_RELAY_MSG imbriqués plus profondément.

[in] nRelayMessages

Taille du tableau, en nombre d’éléments du tableau, vers laquelle pointe le paramètre pRelayMessages .

[out] pnRelayMessages

Spécifie un pointeur vers une valeur ULONG qui, en cas de réussite, reçoit le nombre réel d’éléments écrits dans le tableau pRelayMessages .

[out] ppInnerPacket

Spécifie un pointeur vers une valeur PVOID qui, en cas de réussite, est définie sur le début du paquet le plus interne dans la chaîne de relais. Il s’agit du paquet de requête du client d’origine.

[out] pcbInnerPacket

Spécifie un pointeur vers une valeur ULONG qui, en cas de réussite, sera définie sur la taille, en octets, du paquet le plus interne dans la chaîne de relais, qui est le paquet de requête client d’origine.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wdspxe.h
Bibliothèque	WdsPxe.lib
DLL	WdsPxe.dll