Freigeben über

PxeDhcpv6ParseRelayForw-Funktion (wdspxe.h)

  • Artikel

Diese Funktion kann von einem Anbieter verwendet werden, um RELAY-FORW-Nachrichten und ihre geschachtelten OPTION_RELAY_MSG Nachrichten zu analysieren. Die zurückgegebenen Informationen können verwendet werden, um mithilfe der PxeDhcpv6CreateRepl-Funktion ein RELAY-REPL-Paket zu erstellen.

Weitere Informationen zu RELAY-FORW und OPTION_RELAY_MSG Nachrichten finden Entwickler im Dynamic Host Configuration Protocol for IPv6 (RFC 3315), das von the Internet Engineering Task Force (IETF) verwaltet wird.

Syntax

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

Parameter

[in] pRelayForwPacket

Gibt einen Zeiger auf eine DHCPv6 RELAY-FORW-Nachricht an.

[in] uRelayForwPacketLen

Die Größe der RELAY-FORW-Nachricht in Bytes, auf die der pRelayForwPacket-Parameter verweist.

[out] pRelayMessages

Ein Array von PXE_DHCPV6_NESTED_RELAY_MESSAGE Strukturen, die von dieser Routine initialisiert werden. Die Größe des Arrays wird von nRelayMessages angegeben. Elemente dieses Arrays werden initialisiert, um auf die geschachtelte Kette von Relaypaketen zu verweisen, die in OPTION_RELAY_MSG codiert sind. Index 0 ist das äußerst geschachtelte OPTION_RELAY_MSG Paket. Wenn der Index zunimmt, entsprechen die Zeiger tiefer geschachtelten OPTION_RELAY_MSG Paketen.

[in] nRelayMessages

Die Größe des Arrays in Anzahl der Arrayelemente, auf die der pRelayMessages-Parameter verweist.

[out] pnRelayMessages

Gibt einen Zeiger auf einen ULONG-Wert an, der bei Erfolg die tatsächliche Anzahl von Elementen empfängt, die in das pRelayMessages-Array geschrieben wurden.

[out] ppInnerPacket

Gibt einen Zeiger auf einen PVOID-Wert an, der bei Erfolg auf den Anfang des innersten Pakets in der Relaykette festgelegt wird. Dies ist das ursprüngliche Clientanforderungspaket.

[out] pcbInnerPacket

Gibt einen Zeiger auf einen ULONG-Wert an, der bei Erfolgreicher Ausführung auf die Größe des innersten Pakets in Bytes in der Relaykette festgelegt wird, bei dem es sich um das ursprüngliche Clientanforderungspaket handelt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wdspxe.h
Bibliothek WdsPxe.lib
DLL WdsPxe.dll