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

Artigo
02/27/2024

A função WskListen permite que um soquete de fluxo escute conexões de entrada no endereço associado do soquete.

Sintaxe

PFN_WSK_LISTEN PfnWskListen;

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

Parâmetros

[in] Socket

Um ponteiro para uma estrutura WSK_SOCKET que especifica o objeto de soquete para o soquete de fluxo que está escutando uma conexão de entrada. Esse soquete deve ter sido associado anteriormente a um endereço de transporte local chamando WskBind.

[in, out] Irp

Um ponteiro para um IRP alocado pelo chamador que o subsistema WSK usa para concluir a operação de escuta 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

WskListen retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O soquete de fluxo ouviu uma conexão de entrada com êxito. O IRP será concluído com êxito status.
STATUS_PENDING	O IRP foi enfileirado pelo subsistema WSK, que aguarda uma conexão de entrada no soquete de fluxo.
STATUS_FILE_FORCED_CLOSED	O soquete não está mais funcional. O IRP será concluído com falha status. O aplicativo WSK deve chamar a função WskCloseSocket para fechar o soquete o mais rápido possível.
Outros códigos status	Ocorreu um erro. O IRP será concluído com falha status.

Comentários

Um aplicativo WSK pode chamar a função WskListen somente em um soquete de fluxo que o aplicativo vinculou anteriormente a um endereço de transporte local chamando a função WskBind . Depois que WskListen é chamado com êxito em um soquete de fluxo, o soquete é confirmado em um fluxo de soquete de escuta e não pode mais chamar funções de soquete orientadas à conexão.