Função PostQueuedCompletionStatus (ioapiset.h)
Posta um pacote de conclusão de E/S em uma porta de conclusão de E/S.
Sintaxe
BOOL PostQueuedCompletionStatus(
[in] HANDLE CompletionPort,
[in] DWORD dwNumberOfBytesTransferred,
[in] ULONG_PTR dwCompletionKey,
[in, optional] LPOVERLAPPED lpOverlapped
);
Parâmetros
[in] CompletionPort
Um identificador para uma porta de conclusão de E/S na qual o pacote de conclusão de E/S deve ser postado.
[in] dwNumberOfBytesTransferred
O valor a ser retornado por meio do parâmetro lpNumberOfBytesTransferred da função GetQueuedCompletionStatus.
[in] dwCompletionKey
O valor a ser retornado por meio do parâmetro lpCompletionKey da função GetQueuedCompletionStatus.
[in, optional] lpOverlapped
O valor a ser retornado por meio do parâmetro lpOverlapped da função GetQueuedCompletionStatus.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O pacote de conclusão de E/S atenderá a uma chamada pendente para a função GetQueuedCompletionStatus. Essa função é retornada com os três valores transmitidos como o segundo, o terceiro e o quarto parâmetros da chamada a PostQueuedCompletionStatus. O sistema não usa nem valida esses valores. Mais especificamente, o parâmetro lpOverlapped não precisa apontar para uma estrutura OVERLAPPED.
No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.
| Tecnologia | Com suporte |
|---|---|
| Protocolo SMB (SMB) 3.0 | Sim |
| TFO (Failover transparente) do SMB 3.0 | Sim |
| SMB 3.0 com compartilhamentos de arquivos de expansão (SO) | Sim |
| Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) | Sim |
| ReFS (Sistema de Arquivos Resiliente) | Sim |
CsvFs fará E/S redirecionada em caso de arquivos compactados.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | ioapiset.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |