WsOpenChannel-Funktion (webservices.h)

  • Artikel

Öffnen Sie einen Kanal für einen Endpunkt.

Syntax

HRESULT WsOpenChannel(
  [in]           WS_CHANNEL                *channel,
  [in]           const WS_ENDPOINT_ADDRESS *endpointAddress,
  [in, optional] const WS_ASYNC_CONTEXT    *asyncContext,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] channel

Der zu öffnende Kanal.

[in] endpointAddress

Die Adresse des Endpunkts.

[in, optional] asyncContext

Informationen zum asynchronen Aufrufen der Funktion oder NULL beim synchronen Aufrufen.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen 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.

Hinweise

Wenn das Öffnen erfolgreich ist, muss der Kanal mit WsCloseChannel geschlossen werden, bevor er freigegeben werden kann.

Verwenden Sie WsCreateChannel , um den Kanal zu erstellen.

Sobald ein Kanal für einen Endpunkt geöffnet wurde, erfolgt die gesamte Kommunikation mit diesem Endpunkt.

Die Endpunktadresse und deren Inhalt sind nach der Rückgabe der Funktion nicht erforderlich, auch wenn die Funktion asynchron aufgerufen wird (z. B. kann sie sicher im Stapel deklariert werden).

Ob während dieses Aufrufs tatsächlich E/A stattfindet, hängt vom Typ des Kanals und seinen Einstellungen ab.

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