Méthode IUpdateEndpointProvider::GetServiceEndpoint
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 [entrée]
-
Permet d’identifier le service à mettre à jour.
-
endpointType [entrée]
-
Permet d’identifier 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 installations au service de mise à jour
-
uetWuaSelfUpdate
-
Point de terminaison de mise à jour automatique utilisé lorsque l’ordinateur client contacte un service de mise à jour pour voir 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églementation pour agir sur une mise à jour particulière applicable à l’ordinateur cible.
-
uetSimpleTargeting
-
Point de terminaison à ciblage simple utilisé uniquement avec des services privés (serveurs WSUS dans des environnements d’entreprise).
proxySettings [entrée]
Permet d’identifier les paramètres utilisés lors de la connexion à un serveur proxy.
hUserToken [entrée]
Contient un objet de descripteur 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 [entrée]
Permet d’indiquer si WUA demande un nouveau jeton. La valeur true indique qu’un nouveau jeton est demandé. La valeur false indique qu’un jeton nouveau ou mis en cache est demandé. Pour plus d’informations, consultez la section Remarques.
pbstrEndpointLoc [sortie]
Spécifiez l’URL utilisée pour communiquer avec le service. Par exemple, pour un point de terminaison client-serveur, il s’agit de l’URL du service serveur client. Pour plus d’informations, consultez la section Remarques.
Valeur retournée
Renvoie S_OK en cas de réussite de l’opération. Sinon, retourne un code d’erreur COM ou Windows.
Notes
WUA définit généralement le paramètre fRefreshOnline sur la valeur valse lorsque cette méthode est appelée pour la première fois. Ainsi, si une erreur de connexion se produit, WUA définit ce paramètre sur la valeur true lorsque la méthode est appelée à nouveau. Toutefois, l’implémentation de cette méthode peut demander un nouveau jeton à partir d’un service STS (service d’émission de jeton de sécurité) ou fournir un jeton mis en cache à tout moment.
Si le point de terminaison n’a pas besoin d’authentification, l’appelant peut alors se connecter au service en utilisant l’URL spécifiée par le paramètre pbstrEndpointLoc.
Si le point de terminaison a besoin d’une authentification, l’appelant peut alors 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 | Value |
|---|---|
| Client minimal pris en charge |
Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement] |
| En-tête |
|
| IDL |
|
| Bibliothèque |
|
| DLL |
|
Voir aussi