LPDHCP_HANDLE_OPTIONS回呼函式 (dhcpssdk.h)

  • 發行項

DhcpHandleOptionsHook 函式可讓第三方 DLL 從 DHCP 封包取得常用的選項，以避免需要處理整個 DHCP 封包。 DhcpHandleOptionsHook 函式不應該封鎖。

語法

LPDHCP_HANDLE_OPTIONS LpdhcpHandleOptions;

DWORD LpdhcpHandleOptions(
  [in]      LPBYTE Packet,
  [in]      DWORD PacketSize,
  [in]      LPVOID Reserved,
  [in]      LPVOID PktContext,
  [in, out] LPDHCP_SERVER_OPTIONS ServerOptions
)
{...}

參數

[in] Packet

正在處理的封包緩衝區。

[in] PacketSize

Packet 參數的大小，以位元組為單位。

[in] Reserved

保留以供日後使用。

[in] PktContext

識別封包的內容，如先前 DhcpNewPktHook 函數調用的 PktContext 參數中提供。

[in, out] ServerOptions

類型DHCP_SERVER_OPTIONS結構 ， 其中包含 Microsoft DHCP Server 從封包剖析的資訊，並提供做為常用伺服器選項的集合。

傳回值

傳回值是由提供回呼的應用程式所定義。

備註

當第三方 DLL 的開發人員想要避免處理整個 DHCP 封包時， DhcpHandleOptionsHook 函式很有用，而是可以透過一組常用的伺服器選項來達到所需的結果。 當第三方 DLL 註冊此事件通知時，Microsoft DHCP Server 會剖析傳入封包、擷取常用的伺服器選項，並將它們傳遞至 ServerOptions 參數中的第三方 DLL。

如果 ServerOptions 中指向的DHCP_SERVER_OPTIONS結構超出 DhcpHandleOptionsHook 函數調用完成，則第三方 DLL 必須建立結構的複本。

單一封包可以多次呼叫 DhcpHandleOptionsHook 函式。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 dhcpssdk.h

另請參閱

DHCP_CALLOUT_TABLE

DHCP_SERVER_OPTIONS

DhcpNewPktHook