PxeDhcpv6ParseRelayForw 関数 (wdspxe.h)

この関数は、プロバイダーが RELAY-FORW メッセージとその入れ子になったOPTION_RELAY_MSG メッセージを解析するために使用できます。 返される情報は、 PxeDhcpv6CreateRelayRepl 関数を使用して RELAY-REPL パケットを構築するために使用できます。

RELAY-FORW メッセージとOPTION_RELAY_MSG メッセージの詳細については、開発者は、インターネット エンジニアリング タスク フォース (IETF) によって管理されている IPv6 の動的ホスト構成プロトコル (RFC 3315) を参照する必要があります。

構文

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

パラメーター

[in] pRelayForwPacket

DHCPv6 RELAY-FORW メッセージへのポインターを指定します。

[in] uRelayForwPacketLen

pRelayForwPacket パラメーターが指す RELAY-FORW メッセージのサイズ (バイト単位)。

[out] pRelayMessages

このルーチンによって初期化 されたPXE_DHCPV6_NESTED_RELAY_MESSAGE 構造体の配列。 配列のサイズは nRelayMessages によって指定されます。 この配列の要素は、OPTION_RELAY_MSGでエンコードされたリレー パケットの入れ子になったチェーンを指すように初期化されます。 インデックス 0 は、最も外側の入れ子になったOPTION_RELAY_MSGパケットです。 インデックスが大きくなるにつれて、ポインターはより深く入れ子になったOPTION_RELAY_MSGパケットに対応します。

[in] nRelayMessages

pRelayMessages パラメーターが指す配列要素数の配列のサイズ。

[out] pnRelayMessages

成功した場合に pRelayMessages 配列に書き込まれた要素の実際の数を受け取る ULONG 値へのポインターを指定します。

[out] ppInnerPacket

成功時にリレー チェーン内の最も内側のパケットの先頭に設定される PVOID 値へのポインターを指定します。 これは元のクライアント要求パケットです。

[out] pcbInnerPacket

成功した場合に、元のクライアント要求パケットであるリレー チェーン内の最も内側のパケットのサイズ (バイト単位) に設定される ULONG 値へのポインターを指定します。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wdspxe.h
Library	WdsPxe.lib
[DLL]	WdsPxe.dll