IUpdateEndpointProvider :: GetServiceEndpoint, méthode

Demande un point de terminaison utilisé pour se connecter à un service.

Syntaxe

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

Paramètres

ServiceId [ dans]

Identifie le service à mettre à jour.

endpointType [ dans]

Identifie le type de point de terminaison implémenté par le service.

L’énumération UpdateEndpointType définit les constantes suivantes.

uetClientServer

Point de terminaison client-serveur utilisé pour se connecter au service de mise à jour.

uetReporting

Point de terminaison de création de rapports utilisé lorsque le client signale les résultats des analyses, des téléchargements et des réinstallations dans le service de mise à jour

uetWuaSelfUpdate

Point de terminaison de Self-Update utilisé lorsque l’ordinateur client contacte un service de mise à jour pour déterminer s’il existe une nouvelle version du logiciel client de l’agent Windows Update.

uetRegulation

Point de terminaison de réglementation utilisé lorsque l’ordinateur client contacte le service de régulation pour agir sur une mise à jour particulière applicable à l’ordinateur cible.

uetSimpleTargeting

Simple-Targeting endoint utilisé uniquement avec les services privés (serveurs WSUS dans les environnements d’entreprise).

proxySettings [ dans]

Identifie les paramètres utilisés lors de la connexion à un serveur proxy.

hUserToken [ dans]

Contient un objet de handle de jeton qui représente l’utilisateur. Le fournisseur de points de terminaison utilise ce jeton pour déterminer les paramètres de proxy et les informations d’identification à utiliser.

fRefreshOnline [ dans]

Indique que Weather WUA demande un nouveau jeton. La valeur true indique qu’un nouveau jeton est demandé. False indique qu’un nouveau jeton ou un jeton mis en cache est demandé. Pour plus d'informations, consultez la section Notes.

pbstrEndpointLoc [ à]

Spécifiez l’URL utilisée pour communiquer avec le service. Par exemple, pour un point de terminaison sécurisés-Server, il s’agit de l’URL du service du serveur client. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Retourne S _ OK en cas de réussite. Sinon, retourne un code d’erreur COM ou Windows.

Notes

WUA affecte généralement la valeur false au paramètre fRefreshOnline lorsque cette méthode est appelée pour la première fois, puis, si une erreur de connexion se produit, WUA définit ce paramètre sur true lorsque la méthode est à nouveau appelée. Toutefois, l’implémentation de cette méthode peut demander un nouveau jeton auprès d’un service d’émission de jeton de sécurité (STS) ou fournir un jeton mis en cache à tout moment.

Si le point de terminaison n’a pas besoin d’authentification, l’appelant peut se connecter au service en utilisant uniquement l’URL spécifiée par le paramètre pbstrEndpointLoc .

Si le point de terminaison a besoin d’une authentification, l’appelant peut utiliser l’URL spécifiée par le paramètre pbstrEndpointLoc et les données fournies par les autres paramètres.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows XP, Windows 2000 Professionnel avec les [ applications de bureau SP3 uniquement]
Serveur minimal pris en charge
Windows Server 2003, Windows 2000 Server avec les [ applications de bureau SP3 uniquement]
En-tête
UpdateEndpointAuth. h
MIDL
UpdateEndpointAuth. idl
Bibliothèque
UpdateEndpointAuth. lib
DLL
UpdateEndpointAuth.dll

Voir aussi

IUpdateEndpointProvider