ホーム › NetworkManagement.Dhcp › LPDHCP_HANDLE_OPTIONS

LPDHCP_HANDLE_OPTIONS

コールバック

シグネチャ

DWORD LPDHCP_HANDLE_OPTIONS(
    BYTE* Packet,
    DWORD PacketSize,
    void* Reserved,
    void* PktContext,
    DHCP_SERVER_OPTIONS* ServerOptions
);

パラメーター

フィールド	型	説明
Packet	BYTE*	処理中のパケットのバッファーです。
PacketSize	DWORD	Packet パラメーターのサイズ (バイト単位)。
Reserved	void*	将来の使用のために予約されています。
PktContext	void*	パケットを識別するコンテキストです。直前の DhcpNewPktHook 関数呼び出しの PktContext パラメーターで渡されたものです。
ServerOptions	DHCP_SERVER_OPTIONS*	DHCP_SERVER_OPTIONS 型の構造体で、Microsoft DHCP Server がパケットから解析した情報を、よく使用されるサーバーオプションの集合として格納します。

公式ドキュメント

DhcpHandleOptionsHook 関数を使用すると、サードパーティ製 DLL は DHCP パケット全体を処理することなく、よく使用されるオプションを DHCP パケットから取得できます。 DhcpHandleOptionsHook 関数はブロックしてはなりません。

戻り値

戻り値は、コールバックを提供するアプリケーションによって定義されます。

解説(Remarks)

DhcpHandleOptionsHook 関数は、サードパーティ製 DLL の開発者が DHCP パケット全体の処理を避けたい場合に有用であり、よく使用されるサーバーオプションの集合によって目的の結果を得ることができます。サードパーティ製 DLL がこのイベント通知に登録すると、Microsoft DHCP Server は受信パケットを解析し、よく使用されるサーバーオプションを抽出して、ServerOptions パラメーターでサードパーティ製 DLL に渡します。

ServerOptions が指す DHCP_SERVER_OPTIONS 構造体を DhcpHandleOptionsHook 関数の呼び出しが完了した後も使用する必要がある場合、サードパーティ製 DLL はこの構造体のコピーを作成する必要があります。

DhcpHandleOptionsHook 関数は、1 つのパケットに対して複数回呼び出されることがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)