PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST função de retorno de chamada (wsk.h)
A função WskRelease libera uma lista vinculada de estruturas de WSK_DATAGRAM_INDICATION que foi mantida anteriormente por um aplicativo WSK.
WskRelease pode ser declarado de duas maneiras diferentes, dependendo do tipo de soquete. Este tópico descreve WskRelease para soquetes de datagrama. Para soquetes orientados à conexão ou escuta, consulte WskRelease (soquetes orientados para conexão ou escuta).
Sintaxe
PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;
NTSTATUS PfnWskReleaseDatagramIndicationList(
[in] PWSK_SOCKET Socket,
[in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}
Parâmetros
[in] Socket
Um ponteiro para uma estrutura WSK_SOCKET que especifica o objeto de soquete para o soquete do qual os dados foram recebidos.
[in] DatagramIndication
Um ponteiro para a lista vinculada de estruturas a serem liberadas. Para esse parâmetro, o aplicativo WSK deve especificar o parâmetro DatagramIndication que foi passado para sua função de retorno de chamada de evento WskReceiveEvent ou WskReceiveFromEvent .
Retornar valor
WskRelease retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
A lista de estruturas foi lançada com êxito. |
|
Um parâmetro inválido foi especificado. |
Comentários
Um aplicativo WSK chama a função WskRelease para liberar uma lista vinculada de estruturas de WSK_DATAGRAM_INDICATION que ele reteve anteriormente retornando STATUS_PENDING de seu WskReceiveEvent ou sua função de retorno de chamada de evento WskReceiveFromEvent .
Fechar um soquete chamando a função WskCloseSocket não libera nenhuma lista 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 |
|---|---|
| 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 |