Compartir a través de


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

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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1703
Plataforma de destino Universal
Encabezado wsk.h (incluya Wsk.h)
IRQL <= DISPATCH_LEVEL

Consulte también

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskAccept

WskBind

WskCloseSocket