Função PostQueuedCompletionStatus (ioapiset.h)

  • Artigo

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

Confira também

CreateIoCompletionPort

Funções de gerenciamento de arquivos

GetQueuedCompletionStatus

OVERLAPPED