WsResetChannel-Funktion (webservices.h)

  • Artikel

Setzen Sie einen Kanal zurück, damit er wiederverwendet werden kann.

Syntax

HRESULT WsResetChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

Parameter

[in] channel

Der zurückzusetzende Kanal.

[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_E_INVALID_OPERATION
 Der Kanal befand sich in einem unangemessenen Zustand.

Hinweise

Die Wiederverwendung eines Kanals, anstatt einen von Grund auf neu zu erstellen, kann die Leistung verbessern.

Diese Funktion ist nur gültig, wenn sich der Kanal entweder im WS_CHANNEL_STATE_CREATED - oder WS_CHANNEL_STATE_CLOSED-Zustand befindet.

Wenn sie richtig aufgerufen wird, schlägt diese Funktion nicht fehl (z. B. aufgrund fehlender Systemressourcen).

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