Funzione OpenEventA (synchapi.h)

Articolo
11/20/2024

Apre un oggetto evento denominato esistente.

Sintassi

HANDLE OpenEventA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

Parametri

[in] dwDesiredAccess

Accesso all'oggetto evento. La funzione ha esito negativo se il descrittore di sicurezza dell'oggetto specificato non consente l'accesso richiesto per il processo chiamante. Per un elenco dei diritti di accesso, vedere Synchronization Object Security and Access Rights.

[in] bInheritHandle

Se questo valore è TRUE, i processi creati da questo processo erediteranno l'handle. In caso contrario, i processi non ereditano questo handle.

[in] lpName

Nome dell'evento da aprire. I confronti dei nomi fanno distinzione tra maiuscole e minuscole.

Questa funzione può aprire oggetti in uno spazio dei nomi privato. Per altre informazioni, vedere spazi dei nomi degli oggetti .

Servizi terminal: Il nome può avere un prefisso "Global" o "Local" per aprire in modo esplicito un oggetto nello spazio dei nomi globale o sessione. Il resto del nome può contenere qualsiasi carattere, ad eccezione del carattere barra rovesciata (\). Per altre informazioni, vedere spazi dei nomi dell'oggetto kernel .

Nota passaggio rapido degli utenti viene implementato usando le sessioni di Servizi terminal. Il primo utente a eseguire l'accesso usa la sessione 0, l'utente successivo per accedere usa la sessione 1 e così via. I nomi degli oggetti del kernel devono seguire le linee guida descritte per Servizi terminal in modo che le applicazioni possano supportare più utenti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per l'oggetto evento.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione OpenEvent consente a più processi di aprire handle dello stesso oggetto evento. La funzione ha esito positivo solo se alcuni processi hanno già creato l'evento usando la funzione CreateEvent . Il processo chiamante può usare l'handle restituito in qualsiasi funzione che richiede un handle a un oggetto evento, soggetto alle limitazioni dell'accesso specificato nel parametro dwDesiredAccess.

L'handle può essere duplicato usando la funzione DuplicateHandle. Usare la funzione CloseHandle per chiudere l'handle. Il sistema chiude automaticamente l'handle al termine del processo. L'oggetto evento viene eliminato definitivamente quando l'ultimo handle è stato chiuso.

Nota

L'intestazione synchapi.h definisce OpenEvent come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	synchapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
libreria	Kernel32.lib
dll	Kernel32.dll