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 伺服器）。
proxy 設定 [in]
識別連接到 Proxy 伺服器時所使用的設定。
hUserToken [in]
包含代表使用者的令牌句柄物件。 端點提供者會使用此令牌來判斷要使用的 Proxy 設定和認證。
fRefreshOnline [in]
表示天氣 WUA 要求新的令牌。 True 表示要求新的令牌。 False 表示要求新的或快取的令牌。 如需詳細資訊，請參閱。
pbstrEndpointLoc [out]
指定用來與服務通訊的 URL。 例如，對於用戶端-伺服器端點，這會是用戶端伺服器服務的URL。 如需詳細資訊，請參閱。
傳回值
如果成功，則傳 回S_OK 。 否則，會傳回 COM 或 Windows 錯誤碼。
備註
WUA 通常會在第一次呼叫此方法時， 將 fRefreshOnline 參數設定為 false，則如果發生連接錯誤，當再次呼叫 方法時，WUA 會將該參數設定為 true。 不過，此方法的實作可以從安全性令牌服務 （STS） 要求新的令牌，或隨時提供快取的令牌。
如果端點不需要驗證，則呼叫端只能使用 pbstrEndpointLoc 參數指定的 URL 連線到服務。
如果端點確實需要驗證，則呼叫端可以使用 pbstrEndpointLoc 參數所指定的 URL，以及其他參數所提供的數據。
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP，Windows 2000 Professional with SP3 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003、Windows 2000 Server with SP3 [僅限傳統型應用程式] |
| 頁首 |
|
| IDL |
|
| 程式庫 |
|
| DLL |
|
另請參閱