Função PostQueuedCompletionStatus
Posta um pacote de conclusão de E/S em uma porta de conclusão de E/S.
Sintaxe
BOOL WINAPI PostQueuedCompletionStatus(
_In_ HANDLE CompletionPort,
_In_ DWORD dwNumberOfBytesTransferred,
_In_ ULONG_PTR dwCompletionKey,
_In_opt_ LPOVERLAPPED lpOverlapped
);
Parâmetros
-
CompletionPort [in]
-
Um identificador para uma porta de conclusão de E/S na qual o pacote de conclusão de E/S deve ser postado.
-
dwNumberOfBytesTransferred [in]
-
O valor a ser retornado por meio do parâmetro lpNumberOfBytesTransferred da função GetQueuedCompletionStatus .
-
dwCompletionKey [in]
-
O valor a ser retornado por meio do parâmetro lpCompletionKey da função GetQueuedCompletionStatus .
-
lpOverlapped [in, opcional]
-
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 retorna com os três valores passados como o segundo, o terceiro e o quarto parâmetros da chamada para PostQueuedCompletionStatus. O sistema não usa nem valida esses valores. Em particular, o parâmetro lpOverlapped não precisa apontar para uma estrutura OVERLAPPED .
Em Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.
| Tecnologia | Com suporte |
|---|---|
| Protocolo SMB (Bloco de Mensagens do Servidor) 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 de cluster (CsvFS) |
Sim |
| ReFS (Sistema de Arquivos Resiliente) |
Sim |
Os CsvFs farão E/S redirecionada para 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] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|