Função PostQueuedCompletionStatus

  • Artigo

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
IoAPI.h (inclua Windows.h);
WinBase.h no Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP (inclua Windows.h)
Biblioteca
Kernel32.lib
DLL
Kernel32.dll

Confira também

Createiocompletionport

Funções de gerenciamento de arquivos

GetQueuedCompletionStatus

SOBREPOSTA