Compartir a través de

Función WsAbortListener (webservices.h)

  • Artículo

Cancela cualquier E/S pendiente para el agente de escucha especificado.

Sintaxis

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Parámetros

[in] listener

Puntero a una estructura de WS_LISTENER que representa el agente de escucha 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.

Comentarios

Se puede llamar a WsAbortListener cuando el agente de escucha está en cualquier estado. (Consulte la enumeración WS_LISTENER_STATE para conocer los posibles estados). Si el agente de escucha está en estado WS_LISTENER_STATE_OPEN, esta función obligará al agente de escucha a que se produzca un error (se restablezca el estado WS_LISTENER_STATE_FAULTED). Cuando se produce un error en un agente de escucha, todos los intentos de aceptar un mensaje de él producen un error inmediatamente con el código de error WS_E_OBJECT_FAULTED.

Esta función no espera a que se complete la E/S pendiente.

Si se llama con parámetros válidos, esta función no producirá un error por motivos como la falta de recursos del sistema.

Requisitos

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