共用方式為

PxeProviderRegister 函式 (wdspxe.h)

  • 發行項

向系統註冊提供者。 提供者會在安裝期間使用此函式向系統註冊。 成功註冊時，會傳回登錄機碼句柄，該句柄應該用來儲存組態資訊。

語法

DWORD PXEAPI PxeProviderRegister(
  [in]  LPCWSTR       pszProviderName,
  [in]  LPCWSTR       pszModulePath,
  [in]  PXE_REG_INDEX Index,
  [in]  BOOL          bIsCritical,
  [out] PHKEY         phProviderKey
);

參數

[in] pszProviderName

指定提供者顯示名稱之 Null 終止字串的位址。 此名稱會顯示給使用者，而且在已註冊的提供者之間必須是唯一的。

[in] pszModulePath

指定提供者 DLL 完整路徑之 Null 終止字串的位址。

[in] Index

索引到提供者清單中。 如有需要，任何現有的提供者會向下移轉。 系統管理員可以視需要重新排列提供者，因此不應該假設提供者的順序。

值 意義
PXE_REG_INDEX_TOP
0
 將提供者新增至清單頂端，成為接收用戶端要求的第一個。
PXE_REG_INDEX_BOTTOM
0xFFFFFFFF
 將提供者新增至清單底部。

[in] bIsCritical

指出提供者是否重要。 如果重大提供者失敗，WDS 伺服器也會失敗。

[out] phProviderKey

應該儲存組態的 HKEY 位址。 提供者會收到這個與 hProviderKey 參數相同的密鑰句柄，其 PxeProviderInitialize 回呼。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008、Windows Server 2003 SP2 [僅限桌面應用程式]
目標平台 Windows
標頭 wdspxe.h
程式庫 WdsPxe.lib
Dll WdsPxe.dll

另請參閱

PxeProviderInitialize

PxeProviderUnRegister

Windows 部署服務伺服器函式