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
プロバイダーの一覧にインデックスを作成します。 既存のプロバイダーは、必要に応じてシフトダウンされます。 管理者は必要に応じてプロバイダーを再配置できるため、プロバイダーの順序に関する想定を行う必要はありません。
値 | 意味 |
---|---|
|
プロバイダーを一覧の先頭に追加して、クライアント要求を最初に受信します。 |
|
プロバイダーを一覧の一番下に追加します。 |
[in] bIsCritical
プロバイダーが重要かどうかを示します。 重要なプロバイダーが失敗した場合、WDS サーバーも失敗します。
[out] phProviderKey
構成を格納する 必要がある HKEY のアドレス。 プロバイダーは、PxeProviderInitialize コールバックへの hProviderKey パラメーターと同じキーへのハンドルを受け取ります。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2008、Windows Server 2003 SP2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wdspxe.h |
Library | WdsPxe.lib |
[DLL] | WdsPxe.dll |