Función WsAbortChannel (webservices.h)

  • Artículo

Cancela todas las E/S pendientes de un canal especificado.

Sintaxis

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

Parámetros

[in] channel

Puntero a una estructura de WS_CHANNEL que representa el canal para el que se va a cancelar la E/S.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Código devuelto Descripción
WS_E_NOT_SUPPORTED
 Consulte la sección Comentarios para ver las limitaciones de la plataforma.
E_INVALIDARG
 Uno o más argumentos no son válidos.

Comentarios

Windows Server 2003 y versiones anteriores: En plataformas Windows antes de Windows Vista, esta función no se admite para WS_UDP_CHANNEL_BINDING o WS_HTTP_CHANNEL_BINDING si el canal está en estado WS_CHANNEL_STATE_ACCEPTING y el agente de escucha aún no se ha anulado.

(Para obtener información sobre los enlaces de canal y los estados de canal, consulte las enumeraciones WS_CHANNEL_BINDING y WS_CHANNEL_STATE ).

Esta función tampoco se admite para WS_HTTP_CHANNEL_BINDING con WS_CHANNEL_TYPE_REPLY al anular un canal en el estado WS_CHANNEL_STATE_OPEN o WS_CHANNEL_STATE_FAULTED. (Para obtener información sobre los tipos de canal, consulte la enumeración WS_CHANNEL_TYPE .

Se puede llamar a WsAbortChannel para un canal en cualquier estado y no espera a que se complete la E/S pendiente antes de anular el canal.

Si el canal está en estado de WS_CHANNEL_STATE_OPEN , WsAbortChannel hace que el canal produzca un error en el estado WS_CHANNEL_STATE_FAULTED .

Nota Consulte WsAbandonMessage para obtener información sobre cómo omitir un mensaje determinado y mantener abierto el canal.

 
Si se llama con parámetros válidos, esta función no producirá un error por motivos como la falta de recursos del sistema. Sin embargo, tenga en cuenta las limitaciones de algunas versiones de sistemas operativos al principio de los comentarios.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll