PFN_WSK_LISTEN función de devolución de llamada (wsk.h)

Artículo
03/08/2023

La función WskListen permite que un socket de flujo escuche las conexiones entrantes en la dirección enlazada del socket.

Sintaxis

PFN_WSK_LISTEN PfnWskListen;

NTSTATUS PfnWskListen(
  [in]      PWSK_SOCKET Socket,
  [in, out] PIRP Irp
)
{...}

Parámetros

[in] Socket

Puntero a una estructura de WSK_SOCKET que especifica el objeto de socket para el socket de flujo que escucha una conexión entrante. Este socket debe haberse enlazado previamente a una dirección de transporte local llamando a WskBind.

[in, out] Irp

Puntero a un IRP asignado por el autor de la llamada que usa el subsistema WSK para completar la operación de escucha de forma asincrónica. Para obtener más información sobre el uso de IRP con funciones WSK, consulte Uso de IRP con funciones del kernel de Winsock.

Valor devuelto

WskListen devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	El socket de secuencia escuchó correctamente una conexión entrante. El IRP se completará con el estado correcto.
STATUS_PENDING	El SUBSISTEMA WSK ha puesto en cola el IRP, que está esperando una conexión entrante en el socket de secuencia.
STATUS_FILE_FORCED_CLOSED	El socket ya no es funcional. El IRP se completará con el estado de error. La aplicación WSK debe llamar a la función WskCloseSocket para cerrar el socket lo antes posible.
Otros códigos de estado	Se produjo un error. El IRP se completará con el estado de error.

Comentarios

Una aplicación WSK puede llamar a la función WskListen solo en un socket de flujo que la aplicación enlazaba previamente a una dirección de transporte local llamando a la función WskBind . Una vez que se llama correctamente a WskListen en un socket de flujo, el socket se confirma en un flujo de socket de escucha y ya no puede llamar a funciones de socket orientadas a la conexión.