WsCloseServiceProxy-Funktion (webservices.h)

  • Artikel

Schließt die Kommunikation mit dem angegebenen Dienstproxy.

Syntax

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

Parameter

[in] serviceProxy

Zeiger auf eine WS_SERVICE_PROXY Struktur, die den zu schließenden Dienstproxy darstellt.

[in, optional] asyncContext

Zeiger auf eine WS_ASYNC_CONTEXT-Struktur , die Informationen zum asynchronen Aufrufen der Funktion enthält. Übergeben Sie NULL , um die Funktion synchron aufzurufen.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Beschreibung
WS_S_ASYNC
 Der asynchrone Vorgang steht noch aus.
WS_E_INVALID_OPERATION
 Der aktuelle Status des Dienstproxys ist für diesen Vorgang ungültig. Dies ist nur ein Fehler, bei dem beim Schließen ein Fehler auftritt.
WS_E_ENDPOINT_DISCONNECTED
 Die zugrunde liegende WS_CHANNEL wurde während des Abschlussvorgangs getrennt. Dieser Fehler tritt nur auf, wenn der zugrunde liegende Kanal sitzungsbasiert ist.
WS_E_OPERATION_ABORTED
 Der Vorgang wurde abgebrochen.
WS_E_ENDPOINT_FAILURE
 Der Remoteendpunkt konnte die Anforderung nicht verarbeiten.
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_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
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 ein Dienstvorgangsaufruf für den Dienstproxy aussteht, wartet WsCloseServiceProxy , bis jeder Aufruf abgeschlossen ist. Nach dem Aufruf von WsCloseServiceProxy sollte die Anwendung keine weiteren Aufrufe am Dienstproxy ausführen.

Beachten Sie, dass nur WS_E_INVALID_OPERATION
Fehlercode, der angibt, dass ein Fehler beim Schließen aufgetreten ist. Andere Fehlercodes weisen darauf hin, dass der Vorgang erfolgreich war, und der Fehlercode dient nur zu Informationszwecken.

Anforderungen

   
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