PFN_WSK_CONNECT função de retorno de chamada (wsk.h)

Artigo
08/08/2023

A função WskConnect conecta um soquete de fluxo ou orientado a conexão a um endereço de transporte remoto.

Sintaxe

PFN_WSK_CONNECT PfnWskConnect;

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

Parâmetros

[in] Socket

Um ponteiro para uma estrutura WSK_SOCKET que especifica o objeto de soquete para o soquete que está sendo conectado a um endereço de transporte remoto.

[in] RemoteAddress

Um ponteiro para uma estrutura que especifica o endereço de transporte remoto ao qual conectar o soquete. Esse ponteiro deve ser um ponteiro para o tipo de estrutura SOCKADDR específico que corresponde à família de endereços especificada pelo aplicativo WSK ao criar o soquete.

Flags

Esse parâmetro é reservado para uso do sistema. Um aplicativo WSK deve definir esse parâmetro como zero.

[in, out] Irp

Um ponteiro para um IRP alocado pelo chamador que o subsistema WSK usa para concluir a operação de conexão de forma assíncrona. Para obter mais informações sobre como usar IRPs com funções WSK, consulte Usando IRPs com funções de kernel Winsock.

Retornar valor

WskConnect retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O soquete foi conectado com êxito ao endereço de transporte remoto. O IRP será concluído com êxito status.
STATUS_PENDING	O subsistema WSK não pôde conectar o soquete imediatamente. O subsistema WSK concluirá o IRP depois de conectar o soquete ao endereço de transporte remoto. O status da operação de conexão será retornado no campo IoStatus.Status do IRP.
STATUS_FILE_FORCED_CLOSED	O soquete não é mais funcional. O IRP será concluído com status de falha. O aplicativo WSK deve chamar a função WskCloseSocket para fechar o soquete o mais rápido possível.
Outros códigos de status	Ocorreu um erro. O IRP será concluído com status de falha.

Comentários

Um aplicativo WSK pode chamar a função WskConnect somente em um soquete de fluxo ou orientado a conexão que o aplicativo vinculou anteriormente a um endereço de transporte local chamando a função WskBind .

Para soquetes de fluxo, depois que o WskConnect é chamado com êxito em um soquete de fluxo, o soquete é confirmado em um fluxo orientado à conexão e pode não chamar mais funções de soquete de escuta.

Um aplicativo WSK pode criar, associar e conectar um soquete orientado à conexão em uma única chamada de função chamando a função WskSocketConnect em vez de chamar a função WskSocket , a função WskBind e, em seguida, a função WskConnect . É recomendável chamar a função WskSocketConnect , a menos que o aplicativo WSK precise definir uma opção de soquete ou emitir uma operação de controle de E/S antes de associar ou conectar o soquete.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	wsk.h (inclua Wsk.h)
IRQL	<= DISPATCH_LEVEL