DHCP_CALLOUT_TABLE 結構 (dhcpssdk.h)

發行項
02/29/2024

microsoft DHCP 伺服器和第三方 DLL 會使用 DHCP_CALLOUT_TABLE 結構來傳送 DHCP 伺服器事件的通知要求。

語法

typedef struct _DHCP_CALLOUT_TABLE {
  LPDHCP_CONTROL        DhcpControlHook;
  LPDHCP_NEWPKT         DhcpNewPktHook;
  LPDHCP_DROP_SEND      DhcpPktDropHook;
  LPDHCP_DROP_SEND      DhcpPktSendHook;
  LPDHCP_PROB           DhcpAddressDelHook;
  LPDHCP_GIVE_ADDRESS   DhcpAddressOfferHook;
  LPDHCP_HANDLE_OPTIONS DhcpHandleOptionsHook;
  LPDHCP_DELETE_CLIENT  DhcpDeleteClientHook;
  LPVOID                DhcpExtensionHook;
  LPVOID                DhcpReservedHook;
} DHCP_CALLOUT_TABLE, *LPDHCP_CALLOUT_TABLE;

成員

DhcpControlHook

DhcpControlHook 函式的指標，在第三方 DLL 中實作，在 Microsoft DHCP Server 啟動、停止、暫停或繼續時呼叫。如果不需要通知，請將設定為 NULL 。

DhcpNewPktHook

在第三方 DLL 中實作的 DhcpNewPktHook 函式指標，在 Microsoft DHCP Server 收到嘗試處理的封包時呼叫。如果不需要通知，請將設定為 NULL 。

DhcpPktDropHook

在第三方 DLL 中實作的 DhcpPktDropHook 函式指標，當 Microsoft DHCP Server 卸除封包，以及 Microsoft DHCP Server 完全處理封包時呼叫。如果不需要通知，請將設定為 NULL 。

DhcpPktSendHook

DhcpPktSendHook 函式的指標，在第三方 DLL 中實作，在 Microsoft DHCP Server 提交用戶端查詢的回應之前直接呼叫。如果不需要通知，請將設定為 NULL 。

DhcpAddressDelHook

DhcpAddressDelHook 函式的指標，在第三方 DLL 中實作，當 Microsoft DHCP Server 中的指定事件導致封包遭到捨棄時呼叫。如果不需要通知，請將設定為 NULL 。

DhcpAddressOfferHook

在第三方 DLL 中實作的 DhcpAddressOfferHook 函式指標，在 Microsoft DHCP Server 提交 DHCP ACK 訊息以回應 DHCP 要求訊息之前直接呼叫。如果不需要通知，請將設定為 NULL 。

DhcpHandleOptionsHook

在第三方 DLL 中實作的 DhcpHandleOptionsHook 函式指標，該函式只會將剖析的 DHCP 資訊傳送給第三方 DLL，讓第三方 DLL 避免處理整個 DHCP 封包。如果不需要通知，請將設定為 NULL 。

DhcpDeleteClientHook

在第三方 DLL 中實作的 DhcpDeleteClientHook 函式指標，在 Microsoft DHCP Server 從其作用中租用資料庫刪除用戶端租用之前直接呼叫。如果不需要通知，請將設定為 NULL 。

DhcpExtensionHook

保留供未來使用。

DhcpReservedHook

保留供未來使用。

備註

不需要實作 Microsoft DHCP 伺服器提供的所有勾點。如果不需要特定事件的通知，請將成員設定為 NULL。不過，請記住，最初載入的第三方 DLL 負責載入後續的第三方 DLL，而且後續 DLL 可能需要通知否則為 NULL 的事件，導致鏈結第三方 DLL 所使用的成員非 NULL 設定，否則不會使用。