PFN_WSK_LISTEN função de retorno de chamada (wsk.h)
A função WskListen permite que um soquete de fluxo ouça 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 de WSK_SOCKET que especifica o objeto socket 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 por 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 do WSK, consulte Usando IRPs com funções de kernel winsock.
Valor de retorno
WskListen retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
O soquete de fluxo ouviu uma conexão de entrada com êxito. O IRP será concluído com o status de êxito. |
|
O IRP foi enfileirado pelo subsistema WSK, que está aguardando uma conexão de entrada no soquete de fluxo. |
|
O soquete não está mais funcional. O IRP será concluído com o status de falha. O aplicativo WSK deve chamar a função WskCloseSocket para fechar o soquete o mais rápido possível. |
|
Ocorreu um erro. O IRP será concluído com o status de falha. |
Observações
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 for chamado com êxito em um soquete de fluxo, o soquete será confirmado em um fluxo de soquete de escuta e não poderá mais chamar funções de soquete orientadas à conexão.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1703 |
| da Plataforma de Destino | Universal |
| cabeçalho | wsk.h (inclua Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |