dhcpRegisterParamChange 函式 (dhcpcsdk.h)

  • 發行項

DhcpRegisterParamChange函式可讓用戶端註冊 DHCP 組態參數中的變更通知。

語法

DWORD DhcpRegisterParamChange(
  [in]      DWORD                 Flags,
  [in]      LPVOID                Reserved,
  [in]      LPWSTR                AdapterName,
  [in]      LPDHCPCAPI_CLASSID    ClassId,
  [in]      DHCPCAPI_PARAMS_ARRAY Params,
  [in, out] LPVOID                Handle
);

參數

[in] Flags

保留的。 必須設定為 DHCPCAPI_REGISTER_HANDLE_EVENT。 如果未設定為此旗標值，API 呼叫將不會成功。

[in] Reserved

保留的。 必須設定為 Null。

[in] AdapterName

要求事件通知之配接器的 GUID。 必須低於 256 個字元。

[in] ClassId

保留的。 必須設定為 Null。

[in] Params

用戶端想要註冊通知的參數，其格式為 DHCPCAPI_PARAMS_ARRAY 結構。

[in, out] Handle

Handle的屬性取決於Flags的值。 在 DHCP API 第 2 版中， 旗標 必須設定為 DHCPCAPI_REGISTER_HANDLE_EVENT，因此 Handle 必須是 HANDLE 變數的指標，該變數會保存控制碼，以在 Params 中指定的參數變更時收到訊號的 Windows 事件。 請注意，此 HANDLE 變數會用於 DhcpDeRegisterParamChange 函式的後續呼叫，以取消註冊與 DhcpRegisterParamChange 函式之特定呼叫相關聯的事件通知。

傳回值

成功完成時傳回ERROR_SUCCESS。 否則，會傳回 Windows 錯誤碼。

傳回碼 描述
ERROR_INVALID_PARAMETER
 如果 AdapterName 參數長度超過 256 個字元，則會傳回 。

備註

DHCP 用戶端 API 第 2 版僅提供事件型通知。 在 DHCP 中使用事件型通知時，用戶端會讓 Handle 指向成功傳回時發出訊號的變數，藉此啟用通知。每當參數要求的參數發生變更時， 用戶端就會保留發出訊號的 EVENT 控制碼。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 dhcpcsdk.h
程式庫 Dhcpcsvc.lib
Dll Dhcpcsvc.dll

另請參閱

DHCP 函式

DHCPCAPI_PARAMS_ARRAY

DhcpCApiInitialize

DhcpDeRegisterParamChange