Funzione WsAbortChannel (webservices.h)

Articolo
03/15/2023

Annulla tutte le operazioni di I/O in sospeso per un canale specificato

Sintassi

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

Parametri

[in] channel

Puntatore a una struttura WS_CHANNEL che rappresenta il canale per cui annullare L/O.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni di errore aggiuntive se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito	Descrizione
WS_E_NOT_SUPPORTED	Per le limitazioni della piattaforma, vedere la sezione Osservazioni.
E_INVALIDARG	Uno o più argomenti non sono validi.

Commenti

Windows Server 2003 e prima: Nelle piattaforme Windows prima di Windows Vista questa funzione non è supportata per WS_UDP_CHANNEL_BINDING o WS_HTTP_CHANNEL_BINDING se il canale si trova nello stato WS_CHANNEL_STATE_ACCEPTING e il listener non è già stato interrotto.

Per informazioni sulle associazioni di canale e sugli stati del canale, vedere l'enumerazione WS_CHANNEL_BINDING e WS_CHANNEL_STATE .

Questa funzione non è supportata anche per WS_HTTP_CHANNEL_BINDING con WS_CHANNEL_TYPE_REPLY quando si interrompe un canale nello stato WS_CHANNEL_STATE_OPEN o WS_CHANNEL_STATE_FAULTED. Per informazioni sui tipi di canale, vedere l'enumerazione WS_CHANNEL_TYPE .

WsAbortChannel può essere chiamato per un canale in qualsiasi stato e non attende il completamento dell'I/O in sospeso prima di interrompere il canale.

Se il canale si trova nello stato WS_CHANNEL_STATE_OPEN , WsAbortChannel causa l'errore del canale allo stato di WS_CHANNEL_STATE_FAULTED .

Nota Per informazioni su come ignorare un messaggio specifico, vedere WsAbandonMessage e mantenere aperto il canale.

Se viene chiamato con parametri validi, questa funzione non avrà esito negativo per motivi come la mancanza di risorse di sistema. Si notino tuttavia le limitazioni per alcune versioni dei sistemi operativi all'inizio delle osservazioni.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite