PFN_WSK_RELEASE_DATA_INDICATION_LIST função de retorno de chamada (wsk.h)
A função WskRelease libera uma lista vinculada de estruturas de WSK_DATA_INDICATION que foi retida anteriormente por um aplicativo WSK.
WskRelease pode ser declarada de duas maneiras diferentes, dependendo do tipo de soquete. Este tópico descreve WskRelease para soquetes orientados à conexão ou escuta. Para soquetes de datagram, consulte WskRelease (soquetes de datagram).
Sintaxe
PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;
NTSTATUS PfnWskReleaseDataIndicationList(
[in] PWSK_SOCKET Socket,
[in] PWSK_DATA_INDICATION DataIndication
)
{...}
Parâmetros
[in] Socket
Um ponteiro para uma estrutura de WSK_SOCKET que especifica o objeto socket para o soquete do qual os dados foram recebidos.
[in] DataIndication
Um ponteiro para a lista vinculada de estruturas a serem liberadas. Para esse parâmetro, o aplicativo WSK deve especificar o parâmetro DataIndication que foi passado para sua função de retorno de chamada de evento WskReceiveEvent ou WskReceiveFromEvent função de retorno de chamada de evento.
Valor de retorno
WskRelease retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
A lista de buffers foi lançada com êxito. |
|
Um parâmetro inválido foi especificado. |
Observações
Para soquetes orientados à conexão ou escuta, um aplicativo WSK chama a função WskRelease para liberar uma lista vinculada de estruturas de WSK_DATA_INDICATION que ele reteve anteriormente retornando STATUS_PENDING de sua WskReceiveEvent ou sua função de retorno de chamada de evento WskReceiveFromEvent.
Fechar um soquete chamando a função WskCloseSocket não libera listas de estruturas vinculadas retidas pendentes. Um aplicativo WSK deve liberar todas as listas de estruturas vinculadas retidas antes que o aplicativo chame a função WskCloseSocket para fechar o soquete.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | wsk.h (inclua Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |