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

Artículo
02/07/2025

La función WskConnect conecta un socket orientado a la conexión o a una dirección de transporte remota.

Sintaxis

PFN_WSK_CONNECT PfnWskConnect;

NTSTATUS PfnWskConnect(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR RemoteAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

Parámetros

[in] Socket

Puntero a una estructura de WSK_SOCKET que especifica el objeto de socket para el socket que se está conectando a una dirección de transporte remota.

[in] RemoteAddress

Puntero a una estructura que especifica la dirección de transporte remota a la que se va a conectar el socket. Este puntero debe ser un puntero al tipo de estructura SOCKADDR específico que corresponde a la familia de direcciones que especificó la aplicación WSK cuando creó el socket.

Flags

Este parámetro está reservado para uso del sistema. Una aplicación WSK debe establecer este parámetro en cero.

[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 conexión 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

WskConnect devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	El socket se conectó correctamente a la dirección de transporte remota. El IRP se completará con el estado correcto.
STATUS_PENDING	El subsistema WSK no pudo conectar el socket inmediatamente. El subsistema WSK completará el IRP después de conectar el socket a la dirección de transporte remota. El estado de la operación de conexión se devolverá en el campo IoStatus.Status del IRP.
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	Error. El IRP se completará con el estado de error.

Observaciones

Una aplicación WSK puede llamar a la función WskConnect solo en un socket orientado a la conexión o secuencia que la aplicación anteriormente enlazaba a una dirección de transporte local llamando a la función WskBind.

En el caso de los sockets de flujo, una vez que WskConnect se llama correctamente en un socket de flujo, el socket se confirma en un flujo orientado a la conexión y puede que ya no llame a funciones de socket de escucha.

Una aplicación WSK puede crear, enlazar y conectar un socket orientado a la conexión en una sola llamada de función llamando a la función WskSocketConnect en lugar de llamar a la función WskSocket, la función WskBind y, a continuación, la función WskConnect. Se recomienda llamar a la función WskSocketConnect a menos que la aplicación WSK necesite establecer una opción de socket o emita una operación de control de E/S antes de enlazar o conectar el socket.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de	Universal
encabezado de	wsk.h (incluya Wsk.h)
irQL	<= DISPATCH_LEVEL