Funzione ReportEventA (winbase.h)

Scrive una voce alla fine del registro eventi specificato.

Sintassi

BOOL ReportEventA(
  [in] HANDLE hEventLog,
  [in] WORD   wType,
  [in] WORD   wCategory,
  [in] DWORD  dwEventID,
  [in] PSID   lpUserSid,
  [in] WORD   wNumStrings,
  [in] DWORD  dwDataSize,
  [in] LPCSTR *lpStrings,
  [in] LPVOID lpRawData
);

Parametri

[in] hEventLog

Handle nel registro eventi. La funzione RegisterEventSource restituisce questo handle.

A partire da Windows XP con SP2, questo parametro non può essere un handle per il log di sicurezza . Per scrivere un evento nel log di sicurezza , usare la funzione AuthzReportSecurityEvent .

[in] wType

Tipo di evento da registrare. Questo parametro può avere uno dei valori seguenti.

Per altre informazioni sui tipi di eventi, vedere Tipi di eventi.

[in] wCategory

Categoria di eventi. Si tratta di informazioni specifiche dell'origine; la categoria può avere qualsiasi valore. Per altre informazioni, vedere Categorie di eventi.

[in] dwEventID

Identificatore dell'evento. L'identificatore dell'evento specifica la voce nel file di messaggio associato all'origine evento. Per altre informazioni, vedere Identificatori di evento.

[in] lpUserSid

Puntatore all'identificatore di sicurezza dell'utente corrente. Questo parametro può essere NULL se l'identificatore di sicurezza non è obbligatorio.

[in] wNumStrings

Numero di stringhe di inserimento nella matrice a cui punta il parametro lpStrings . Un valore pari a zero indica che non sono presenti stringhe.

[in] dwDataSize

Numero di byte di dati non elaborati (binari) specifici dell'evento da scrivere nel log. Se questo parametro è zero, non sono presenti dati specifici dell'evento.

[in] lpStrings

Puntatore a un buffer contenente una matrice di stringhe con terminazione null unite al messaggio prima di Visualizzatore eventi visualizza la stringa all'utente. Questo parametro deve essere un puntatore valido (o NULL), anche se wNumStrings è zero. Ogni stringa è limitata a 31.839 caratteri.

Prima di Windows Vista: Ogni stringa è limitata a 32 caratteri.

[in] lpRawData

Puntatore al buffer contenente i dati binari. Questo parametro deve essere un puntatore valido (o NULL), anche se il parametro dwDataSize è zero.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero, che indica che la voce è stata scritta nel log.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare GetLastError, che restituisce uno dei codici di errore estesi seguenti.

Commenti

Questa funzione viene usata per registrare un evento. La voce viene scritta alla fine del log configurato per l'origine identificata dal parametro hEventLog . La funzione ReportEvent aggiunge il tempo, la lunghezza della voce e gli offset prima di archiviare la voce nel log. Per abilitare la funzione per aggiungere il nome utente, è necessario specificare il SID dell'utente nel parametro lpUserSid .

Esistono limiti di dimensioni diverse sulle dimensioni dei dati del messaggio che possono essere registrati a seconda della versione di Windows usata da entrambi i client in cui viene eseguita l'applicazione e il server in cui viene registrato il messaggio. Il server viene determinato dal parametro lpUNCServerName passato alla funzione RegisterEventSource . Vengono restituiti errori diversi quando viene superato il limite di dimensioni che dipendono dalla versione di Windows.

Se la stringa del log contiene %n, dove n è un valore intero ,ad esempio %1, il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo IPv6 può contenere questa sequenza di caratteri, è necessario specificare un identificatore di formato (! S!) per registrare un messaggio di evento contenente un indirizzo IPv6. Questo identificatore indica al codice di formattazione di usare la stringa letteralmente e non eseguire ulteriori espansioni,ad esempio "l'indirizzo IPv6 è: %1! S!").

Esempio

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

Requisiti

Vedi anche

ClearEventLog

CloseEventLog

Formato file di log eventi

Funzioni di registrazione eventi

OpenEventLog

ReadEventLog

RegisterEventSource