IUpdateEndpointProvider::GetServiceEndpoint メソッド
サービスへの接続に使用されるエンドポイントを要求します。
構文
HRESULT GetServiceEndpoint(
[in] GUID ServiceId,
[in] UpdateEndpointType endpointType,
[in] UpdateEndpointProxySettings proxySettings,
[in] HANDLE_PTR hUserToken,
[in] BOOL fRefreshOnline,
[out] BSTR *pbstrEndpointLoc
);
パラメーター
-
ServiceId [in]
-
更新するサービスを識別します。
-
endpointType [in]
-
サービスによって実装されるエンドポイントの種類を識別します。
UpdateEndpointType 列挙では、次の定数を定義します。
-
uetClientServer
-
更新サービスへの接続に使用されるクライアント/サーバー エンドポイント。
-
uetReporting
-
クライアントがスキャン、ダウンロード、インストールの結果を更新サービスに報告するときに使用されるレポート エンドポイント
-
uetWuaSelfUpdate
-
クライアント コンピューターが更新サービスに接続し、Windows Update エージェント クライアント ソフトウェアの新しいバージョンがあるかどうかを確認するときに使用される自己更新エンドポイント。
-
uetRegulation
-
クライアント コンピューターが規制サービスに接続して、ターゲット コンピューターに適用できる特定の更新プログラムに対応する場合に使用される規制エンドポイント。
-
uetSimpleTargeting
-
プライベート サービス (企業の環境内の WSUS サーバー) でのみ使用されるシンプルターゲット エンドポイント。
proxySettings [in]
プロキシ サーバーに接続するときに使用される設定を識別します。
hUserToken [in]
ユーザーを表すトークン ハンドル オブジェクトを含みます。 エンドポイント プロバイダーは、このトークンを使用して、使用するプロキシ設定と資格情報を決定します。
fRefreshOnline [in]
WUA が新規のトークンを要求するかどうかを示します。 True は、新規のトークンを要求することを示します。 False は、新規、またはキャッシュされたトークンを要求することを示します。 詳細については、「解説」を参照してください。
pbstrEndpointLoc [out]
サービスとの通信に使用する URL を指定します。 たとえば、クライアント/サーバー エンドポイントの場合、これはクライアント サーバー サービスへの URL になります。 詳細については、「解説」を参照してください。
戻り値
成功すると、S_OK が返されます。 それ以外の場合は、COM または Windows エラー コードを返します。
解説
通常、WUA は、このメソッドが最初に呼び出されたときに fRefreshOnline パラメーターを false に設定します。次に、接続エラーが発生すると、メソッドが再度呼び出されたときに WUA がそのパラメーターを true に設定します。 ただし、このメソッドの実装は、Security Token Service (STS) に新しいトークンを要求したり、キャッシュされたトークンをいつでも提供したりできます。
エンドポイントで認証が必要でない場合、呼び出し元は pbstrEndpointLoc パラメーターによって指定された URL のみを使用してサービスに接続できます。
エンドポイントで認証が必要な場合、呼び出し元は pbstrEndpointLoc パラメーターによって指定された URL と、他のパラメーターによって提供されたデータを使用できます。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ] |
| ヘッダー |
|
| IDL |
|
| ライブラリ |
|
| [DLL] |
|
関連項目