Función PostQueuedCompletionStatus (ioapiset.h)

Publica un paquete de finalización de E/S en un puerto de finalización de E/S.

Sintaxis

BOOL PostQueuedCompletionStatus(
  [in]           HANDLE       CompletionPort,
  [in]           DWORD        dwNumberOfBytesTransferred,
  [in]           ULONG_PTR    dwCompletionKey,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parámetros

[in] CompletionPort

Identificador de un puerto de finalización de E/S en el que se va a publicar el paquete de finalización de E/S.

[in] dwNumberOfBytesTransferred

Valor que se va a devolver a través del parámetro lpNumberOfBytesTransferred de la función GetQueuedCompletionStatus.

[in] dwCompletionKey

Valor que se va a devolver a través del parámetro lpCompletionKey de la función GetQueuedCompletionStatus.

[in, optional] lpOverlapped

Valor que se va a devolver a través del parámetro lpOverlapped de la función GetQueuedCompletionStatus.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para información de error extendida, llame a GetLastError .

Comentarios

El paquete de finalización de E/S cumplirá con una llamada pendiente a la función GetQueuedCompletionStatus. Esta función se devuelve con los tres valores pasados como segundo, tercer y cuarto parámetro de la llamada a PostQueuedCompletionStatus. El sistema no usa ni valida estos valores. En concreto, el parámetro lpOverlapped no debe apuntar a una estructura SUPERPUESTA.

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología	Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0	Sí
Conmutación por error transparente (TFO) de SMB 3.0	Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS)	Sí
Sistema de archivos resistente a errores (ReFS)	Sí

 

CsvFs realizará la E/S redirigida para los archivos comprimidos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	ioapiset.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

CreateIoCompletionPort

Funciones de administración de archivos

GetQueuedCompletionStatus

OVERLAPPED