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) |