WsOpenServiceProxy-Funktion (webservices.h)

Öffnet einen Dienstproxy für einen Dienstendpunkt.

Bei erfolgreicher Ausführung können Clientanwendungen Aufrufe mit dem Dienstproxy tätigen. Das Verhalten von WsOpenServiceProxy wird durch die verwendete Kanalbindung gesteuert.

Syntax

HRESULT WsOpenServiceProxy(
  [in]           WS_SERVICE_PROXY          *serviceProxy,
  [in]           const WS_ENDPOINT_ADDRESS *address,
  [in, optional] const WS_ASYNC_CONTEXT    *asyncContext,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] serviceProxy

Ein Zeiger auf den zu öffnenden Dienstproxy . Der Zeiger muss auf ein gültiges WS_SERVICE_PROXY-Objekt verweisen, und der wert, auf den verwiesen wird, ist möglicherweise nicht NULL.

[in] address

Ein Zeiger auf die Adresse des Endpunkts.

[in, optional] asyncContext

Ein Zeiger auf ein WS_ASYNC_CONTEXT-Objekt, das Informationen zum asynchronen Aufrufen der Funktion enthält. Der Wert wird auf NULL festgelegt, wenn synchron aufgerufen wird.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
WS_S_ASYNC	Der asynchrone Vorgang steht noch aus.
WS_E_OPERATION_ABORTED	Der Vorgang wurde abgebrochen.
WS_E_INVALID_OPERATION	Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_ENDPOINT_NOT_FOUND	Der Remoteendpunkt ist nicht vorhanden oder konnte nicht gefunden werden.
WS_E_ENDPOINT_ACCESS_DENIED	Der Zugriff wurde vom Remoteendpunkt verweigert.
WS_E_ENDPOINT_DISCONNECTED	Die Verbindung mit dem Remoteendpunkt wurde beendet.
WS_E_ENDPOINT_FAILURE	Der Remoteendpunkt konnte die Anforderung nicht verarbeiten.
WS_E_ENDPOINT_NOT_AVAILABLE	Der Remoteendpunkt ist an diesem Standort derzeit nicht im Dienst.
WS_E_ENDPOINT_TOO_BUSY	Der Remoteendpunkt kann die Anforderung aufgrund einer Überlastung nicht verarbeiten.
WS_E_ENDPOINT_UNREACHABLE	Der Remoteendpunkt war nicht erreichbar.
WS_E_INVALID_ENDPOINT_URL	Die Endpunktadressen-URL ist ungültig.
WS_E_INVALID_FORMAT	Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
WS_E_OPERATION_TIMED_OUT	Der Vorgang wurde nicht innerhalb der zugewiesenen Zeit abgeschlossen.
WS_E_PROXY_ACCESS_DENIED	Der Zugriff wurde vom HTTP-Proxyserver verweigert.
WS_E_PROXY_FAILURE	Der HTTP-Proxyserver konnte die Anforderung nicht verarbeiten.
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.
WS_E_SECURITY_VERIFICATION_FAILURE	Die Sicherheitsüberprüfung war für die empfangenen Daten nicht erfolgreich.
WS_E_SECURITY_SYSTEM_FAILURE	Fehler bei einem Sicherheitsvorgang im Windows-Webdienstframework.
WS_E_PROXY_REQUIRES_BASIC_AUTH	Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "basic".
WS_E_PROXY_REQUIRES_DIGEST_AUTH	Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "digest".
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH	Für den HTTP-Proxyserver ist das HTTP-Authentifizierungsschema "negotiate" erforderlich.
WS_E_PROXY_REQUIRES_NTLM_AUTH	Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "NTLM".
WS_E_SERVER_REQUIRES_BASIC_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "basic" erforderlich.
WS_E_SERVER_REQUIRES_DIGEST_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "digest" erforderlich.
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "negotiate" erforderlich.
WS_E_SERVER_REQUIRES_NTLM_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "NTLM" erforderlich.
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll