Funzione RegisterEventSourceA (winbase.h)

  • Articolo

Recupera un handle registrato nel registro eventi specificato.

Sintassi

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

Parametri

[in] lpUNCServerName

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

[in] lpSourceName

Nome dell'origine evento il cui handle deve essere recuperato. Il nome dell'origine deve essere una sottochiave di un log nella chiave del Registro di sistema del registro eventi . Si noti che il log di sicurezza è destinato solo all'uso del sistema.

Nota Questa stringa non deve contenere caratteri non consentiti negli attributi XML, ad eccezione delle sequenze di escape XML, ad esempio < &gl.
 

Valore restituito

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

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

La funzione restituisce ERROR_ACCESS_DENIED se lpSourceName specifica il registro eventi di sicurezza .

Commenti

Se non è possibile trovare il nome di origine, il servizio di registrazione eventi usa il registro applicazioni . Anche se gli eventi verranno segnalati , gli eventi non includeranno descrizioni perché non sono presenti file di messaggio e di categoria per cercare descrizioni correlate agli identificatori di evento.

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

Esempio

Per un esempio, vedere Creazione di report di un evento.

Nota

L'intestazione winbase.h definisce RegisterEventSource 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

Requisito Valore
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

Vedi anche

DeregisterEventSource

Funzioni di registrazione eventi

Origini eventi

Reportevent