Función PostQueuedCompletionStatus

  • Artículo

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

Sintaxis

BOOL WINAPI PostQueuedCompletionStatus(
  _In_     HANDLE       CompletionPort,
  _In_     DWORD        dwNumberOfBytesTransferred,
  _In_     ULONG_PTR    dwCompletionKey,
  _In_opt_ LPOVERLAPPED lpOverlapped
);

Parámetros

CompletionPort [in]

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

dwNumberOfBytesTransferred [in]

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

dwCompletionKey [in]

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

lpOverlapped [in, opcional]

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 obtener información de error extendida, llame a GetLastError .

Comentarios

El paquete de finalización de E/S satisfará una llamada pendiente a la función GetQueuedCompletionStatus . Esta función devuelve con los tres valores pasados como segundo, tercero y cuarto parámetros 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 siguientes tecnologías.

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]
Encabezado
IoAPI.h (incluye Windows.h);
WinBase.h en Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP (incluye Windows.h)
Biblioteca
Kernel32.lib
Archivo DLL
Kernel32.dll

Vea también

CreateIoCompletionPort

Funciones de administración de archivos

GetQueuedCompletionStatus

COMPROMETIDOS