Win32 API 日本語リファレンス
ホーム › NetworkManagement.Dhcp › LPDHCP_PROB

LPDHCP_PROB

コールバック

シグネチャ

DWORD LPDHCP_PROB(
    BYTE* Packet,
    DWORD PacketSize,
    DWORD ControlCode,
    DWORD IpAddress,
    DWORD AltAddress,
    void* Reserved,
    void* PktContext
);

パラメーター

フィールド型説明
PacketBYTE*処理中のパケットのバッファーです。
PacketSizeDWORDPacket パラメーターのサイズ (バイト単位)。
ControlCodeDWORDイベントを指定します。コントロールコードの定義については「解説」を参照してください。
IpAddressDWORDパケットを受信したソケットのインターネットプロトコル (IP) アドレスです。この IP アドレスはホストバイトオーダーです。
AltAddressDWORDイベントに関する追加情報を提供するために使用されるインターネットプロトコル (IP) アドレスです。AltAddress の意味は ControlCode の値によって異なります。「解説」を参照してください。
Reservedvoid*将来の使用のために予約されています。
PktContextvoid*パケットを識別するコンテキストです。以前の DhcpNewPktHook 関数呼び出しの PktContext パラメーターで指定されたものです。

公式ドキュメント

DhcpAddressDelHook 関数は、次の 4 つの定義済みイベントのいずれかが発生したときに Microsoft DHCP Server によって呼び出されます:

これらのイベントの詳細については「解説」を参照してください。 DhcpAddressDelHook 関数は、Microsoft DHCP Server の重要なイベントの通知を受け取るために登録されたサードパーティ製 DLL によって実装されます。 DhcpAddressDelHook 関数はブロックしてはいけません。

戻り値

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

解説(Remarks)

次の表に、Microsoft DHCP Server がサードパーティ製 DLL 内の DhcpAddressDelHook 関数を呼び出すきっかけとなる、4 つの定義済みイベントを示します。

コントロールコード 説明
DHCP_PROB_CONFLICT AltAddress で指定された、提供しようとしたアドレスが、ネットワーク上で既に使用されています。
DHCP_PROB_DECLINE パケットは、AltAddress で指定されたアドレスに対する DECLINE メッセージでした。
DHCP_PROB_RELEASE パケットは、AltAddress で指定されたアドレスに対する RELEASE メッセージでした。
DHCP_PROB_NACKED パケットは、AltAddress で指定されたアドレスに対する REQUEST メッセージでしたが、その要求は Microsoft DHCP Server によって拒否されました。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)