IUpdateEndpointProvider::GetServiceEndpoint method

Artikel
12/18/2023

Fordert einen Endpunkt an, der zum Herstellen einer Verbindung mit einem Dienst verwendet wird.

Syntax

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

Parameter

ServiceId [in]

Identifiziert den Dienst, der aktualisiert werden soll.

endpointType [in]

Identifiziert den vom Dienst implementierten Endpunkttyp.

Die Enumeration UpdateEndpointType definiert die folgenden Konstanten.

uetClientServer

Ein Clientserverendpunkt, der zum Herstellen einer Verbindung mit dem Updatedienst verwendet wird.

uetReporting

Ein Berichterstellungsendpunkt, der verwendet wird, wenn der Client die Ergebnisse von Überprüfungen, Downloads und Installationen zurück an den Updatedienst meldet.

uetWuaSelfUpdate

Ein Selbstaktualisierungsendpunkt, der verwendet wird, wenn der Clientcomputer einen Updatedienst kontaktiert, um zu ermitteln, ob eine neue Version der Clientsoftware für den Windows Update-Agent verfügbar ist.

uetRegulation

Ein Regulierungsendpunkt, der verwendet wird, wenn der Clientcomputer den Regulierungsdienst kontaktiert, um auf ein bestimmtes Update zu reagieren, das auf den Zielcomputer anwendbar ist.

uetSimpleTargeting

Ein Einzelzielendpunkt, der nur für private Dienste (WSUS-Server in Unternehmensumgebungen) verwendet wird.

proxySettings [in]

Identifiziert die Einstellungen, die beim Herstellen einer Verbindung mit einem Proxyserver verwendet werden.

hUserToken [in]

Enthält ein Tokenhandleobjekt, das den Benutzer oder die Benutzerin darstellt. Der Endpunktanbieter verwendet dieses Token, um zu bestimmen, welche Proxyeinstellungen und Anmeldeinformationen verwendet werden sollen.

fRefreshOnline [in]

Gibt an, ob WUA ein neues Token anfordert. „True“ gibt an, dass ein neues Token angefordert wird. „False“ gibt an, dass ein neues oder zwischengespeichertes Token angefordert wird. Weitere Informationen finden Sie unter Hinweise.

pbstrEndpointLoc [out]

Geben Sie die URL an, die für die Kommunikation mit dem Dienst verwendet wird. Bei einem Clientserverendpunkt wäre dies beispielsweise die URL zum Clientserverdienst. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Gibt bei Erfolg S_OK zurück. Andernfalls wird ein COM- oder Windows-Fehlercode zurückgegeben.

Hinweise

WUA legt den ParameterfRefreshOnline in der Regel auf „false“ fest, wenn diese Methode zum ersten Mal aufgerufen wird. Wenn ein Verbindungsfehler auftritt, legt WUA diesen Parameter auf „true“ fest, wenn die Methode erneut aufgerufen wird. Die Implementierung dieser Methode kann jedoch jederzeit ein neues Token von einem Sicherheitstokendienst (Security Token Service, STS) anfordern oder ein zwischengespeichertes Token bereitstellen.

Wenn der Endpunkt keine Authentifizierung benötigt, kann der Aufrufer nur mithilfe der durch den Parameter pbstrEndpointLoc angegebenen URL eine Verbindung mit dem Dienst herstellen.

Wenn der Endpunkt eine Authentifizierung benötigt, kann der Aufrufer die durch den Parameter pbstrEndpointLoc URL und die von den anderen Parametern bereitgestellten Daten verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Header	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
Bibliothek	UpdateEndpointAuth.lib
DLL	UpdateEndpointAuth.dll

Siehe auch

IUpdateEndpointProvider

Freigeben über