Funzione OpenEventLogA (winbase.h)

Articolo
03/08/2023

Apre un handle al registro eventi specificato.

Sintassi

HANDLE OpenEventLogA(
  [in] LPCSTR lpUNCServerName,
  [in] LPCSTR lpSourceName
);

Parametri

[in] lpUNCServerName

Nome UNC (Universal Naming Convention) del server remoto in cui deve essere aperto il registro eventi. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] lpSourceName

Nome del log.

Se si specifica un log personalizzato e non è possibile trovarlo, il servizio di registrazione eventi apre il registro applicazioni ; Tuttavia, non sarà presente alcun file di stringa di messaggio o categoria associato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle di un registro eventi.

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

Commenti

Per chiudere l'handle al registro eventi, usare la funzione CloseEventLog .

Esempio

Per un esempio, vedere Esecuzione di query per informazioni sugli eventi.

Nota

L'intestazione winbase.h definisce OpenEventLog 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll
Set di API	ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introdotto in Windows 10 versione 10.0.10240)