WsCloseServiceProxy-Funktion (webservices.h)

Artikel
08/27/2023

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

Freigeben über