Funzione GetUmsCompletionListEvent (winbase.h)

  • Articolo

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)

Vedi anche

CreateUmsCompletionList

DequeueUmsCompletionListItems

Funzioni wait