Función GetUmsCompletionListEvent (winbase.h)

Recupera un identificador para el evento asociado a la lista de finalización de programación en modo de usuario (UMS) especificada.

Advertencia

A partir de Windows 11, no se admite la programación en modo de usuario. Todas las llamadas producen el error ERROR_NOT_SUPPORTED.

Sintaxis

BOOL GetUmsCompletionListEvent(
  [in]      PUMS_COMPLETION_LIST UmsCompletionList,
  [in, out] PHANDLE              UmsCompletionEvent
);

Parámetros

[in] UmsCompletionList

Puntero a una lista de finalización de UMS. La función CreateUmsCompletionList proporciona este puntero.

[in, out] UmsCompletionEvent

Puntero a una variable HANDLE. En la salida, el parámetro UmsCompletionEvent se establece en un identificador para el evento asociado a la lista de finalización especificada.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un valor 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 sistema indica un evento de lista de finalización de UMS cuando el sistema pone en cola los elementos a una lista de finalización vacía. Se puede usar un identificador de eventos de lista de finalización con cualquier función de espera que tome un identificador a un evento. Cuando se señala el evento, una aplicación normalmente llama a DequeueUmsCompletionListItems para recuperar el contenido de la lista de finalización.

El identificador de eventos permanece válido hasta que se elimina su lista de finalización. No use el identificador de eventos para esperar en una lista de finalización que se haya eliminado o esté en proceso de eliminación.

Cuando el identificador ya no sea necesario, use la función CloseHandle para cerrar el identificador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 (solo 64 bits) [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll
Conjunto de API	api-ms-win-core-ums-l1-1-0 (introducido en Windows 7)

Consulte también

CreateUmsCompletionList

DequeueUmsCompletionListItems

Funciones wait