WsAbandonCall-Funktion (webservices.h)

  • Artikel

Gibt einen angegebenen Aufruf für den angegebenen Dienstproxy ab.

Syntax

HRESULT WsAbandonCall(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in]           ULONG            callId,
  [in, optional] WS_ERROR         *error
);

Parameter

[in] serviceProxy

Zeiger auf eine WS_SERVICE_PROXY-Struktur , die den Dienstproxy darstellt, für den der Aufruf abgebrochen werden soll.

[in] callId

ID des abzubrechenden Aufrufs. (Weitere Informationen finden Sie im Abschnitt "Hinweise".)

[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, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Beschreibung
WS_E_INVALID_OPERATION
 Der aktuelle Status des Dienstproxys ist für diesen Vorgang ungültig.
E_INVALIDARG
 Ein NULL-Dienstproxy wurde an die Funktion übergeben.

Hinweise

Anrufe werden durch eine Anruf-ID identifiziert. Diese Aufruf-ID wird dem Aufruf durch den WS_CALL_PROPERTY_CALL_ID-Wert der WS_CALL_PROPERTY_ID-Enumeration zugeordnet.

Wenn die Anruf-ID 0 ist, werden alle ausstehenden Aufrufe auf dem Dienstproxy abgebrochen. Weitere Informationen finden Sie in den folgenden Themen:

Beachten Sie, dass die dem Anruf zugeordnete tatsächliche E/A nicht abgebrochen wird. Der Dienstproxy behält die Ressourcen zum Abschließen des Aufrufs bei, obwohl der Aufruf abgebrochen wurde.

Dies führt zu einem Ressourcenverbrauch, der verschlimmert wird, wenn eine Anwendung weiterhin Aufrufe abgibt, wie dies der Fall sein kann, wenn der Server langsam auf den Client reagiert und die Clientanwendung nur einen Aufruf abgibt, um denselben Aufruf erneut zu tätigen.

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