Metodo IUpdateEndpointProvider::GetServiceEndpoint

Articolo
12/06/2023

Richiede un endpoint usato per connettersi a un servizio.

Sintassi

HRESULT GetServiceEndpoint(
  [in]  GUID                        ServiceId,
  [in]  UpdateEndpointType          endpointType,
  [in]  UpdateEndpointProxySettings proxySettings,
  [in]  HANDLE_PTR                  hUserToken,
  [in]  BOOL                        fRefreshOnline,
  [out] BSTR                        *pbstrEndpointLoc
);

Parametri

ServiceId [in]

Identifica il servizio da aggiornare.

endpointType [in]

Identifica il tipo di endpoint implementato dal servizio.

L'enumerazione UpdateEndpointType definisce le costanti seguenti.

uetClientServer

Endpoint client-server usato per connettersi al servizio di aggiornamento.

uetReporting

Endpoint di report utilizzato quando il client segnala i risultati delle analisi, dei download e delle installazioni al servizio di aggiornamento

uetWuaSelfUpdate

Endpoint di aggiornamento automatico usato quando il computer client contatta un servizio di aggiornamento per verificare se è presente una nuova versione del software client dell'agente di Windows Update.

uetRegulation

Endpoint di regolamento utilizzato quando il computer client contatta il servizio di regolazione per agire su un particolare aggiornamento applicabile al computer di destinazione.

uetSimpleTargeting

Endpoint di selezione semplice usato solo con servizi privati (server WSUS in ambienti aziendali).

proxy Impostazioni [in]

Identifica le impostazioni utilizzate per la connessione a un server proxy.

hUserToken [in]

Contiene un oggetto handle di token che rappresenta l'utente. Il provider di endpoint usa questo token per determinare quali impostazioni proxy e credenziali usare.

fRefreshOnline [in]

Indica che wua meteo richiede un nuovo token. True indica che viene richiesto un nuovo token. False indica che è richiesto un token nuovo o memorizzato nella cache. Vedere osservazioni Per ulteriori informazioni.

pbstrEndpointLoc [out]

Specificare l'URL usato per comunicare con il servizio. Ad esempio, per un endpoint client-server si tratta dell'URL del servizio server client. Vedere osservazioni Per ulteriori informazioni.

Valore restituito

Restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un codice di errore COM o Windows.

Osservazioni:

WUA imposta in genere il parametro fRefreshOnline su false quando questo metodo viene chiamato per la prima volta, se si verifica un errore di connessione WUA imposta tale parametro su true quando il metodo viene chiamato di nuovo. Tuttavia, l'implementazione di questo metodo può richiedere un nuovo token da un servizio token di sicurezza (STS) o fornire un token memorizzato nella cache in qualsiasi momento.

Se l'endpoint non richiede l'autenticazione, il chiamante può connettersi al servizio usando solo l'URL specificato dal parametro pbstrEndpointLoc .

Se l'endpoint richiede l'autenticazione, il chiamante può usare l'URL specificato dal parametro pbstrEndpointLoc e i dati forniti dagli altri parametri.

Requisiti

Requisito	valore
Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Intestazione	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
Libreria	UpdateEndpointAuth.lib
DLL	UpdateEndpointAuth.dll

Vedi anche

IUpdateEndpointProvider

Condividi tramite