Funzione GetUmsCompletionListEvent (winbase.h)
Recupera un handle per l'evento associato all'elenco di completamento della pianificazione in modalità utente (UMS) specificato.
Avviso
A partire da Windows 11, la pianificazione in modalità utente non è supportata. Tutte le chiamate hanno esito negativo con l'errore ERROR_NOT_SUPPORTED.
Sintassi
BOOL GetUmsCompletionListEvent(
[in] PUMS_COMPLETION_LIST UmsCompletionList,
[in, out] PHANDLE UmsCompletionEvent
);
Parametri
[in] UmsCompletionList
Puntatore a un elenco di completamento UMS. La funzione CreateUmsCompletionList fornisce questo puntatore.
[in, out] UmsCompletionEvent
Puntatore a una variabile HANDLE. Nell'output, il parametro UmsCompletionEvent è impostato su un handle per l'evento associato all'elenco di completamento specificato.
Valore restituito
Se la funzione ha esito positivo, restituisce un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Il sistema segnala un evento di elenco di completamento UMS quando le voci di sistema vengono accodato a un elenco di completamento vuoto. Un handle di evento dell'elenco di completamento può essere usato con qualsiasi funzione di attesa che accetta un handle per un evento. Quando l'evento viene segnalato, un'applicazione chiama in genere DequeueUmsCompletionListItems per recuperare il contenuto dell'elenco di completamento.
L'handle eventi rimane valido fino a quando non viene eliminato l'elenco di completamento. Non usare l'handle di evento per attendere un elenco di completamento eliminato o in corso di eliminazione.
Quando l'handle non è più necessario, usare la funzione CloseHandle per chiudere l'handle.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 (solo a 64 bit) [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |
| Set di API | api-ms-win-core-ums-l1-1-0 (introdotto in Windows 7) |