Funzione AuthzReportSecurityEvent (authz.h)

La funzione AuthzReportSecurityEvent genera un controllo di sicurezza per un'origine evento di sicurezza registrata.

Il controllo per la categoria di eventi di accesso agli oggetti deve essere abilitato per la funzione AuthzReportSecurityEvent per generare un controllo di sicurezza. I tipi di controllo disponibili sono definiti nell'enumerazione AUDIT_PARAM_TYPE .

Sintassi

AUTHZAPI BOOL AuthzReportSecurityEvent(
  [in]           DWORD                                dwFlags,
  [in, out]      AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           DWORD                                dwCount,
                 ...                                  
);

Parametri

[in] dwFlags

Flag che specificano il tipo di controllo generato. Nella tabella seguente sono illustrati i possibili valori.

Valore Significato
APF_AuditFailure
0x00000000
Vengono generati controlli di errore.
APF_AuditSuccess
0x00000001
Vengono generati controlli di esito positivo.

[in, out] hEventProvider

Handle per l'origine evento di sicurezza registrata da usare per il controllo.

[in] dwAuditId

Identificatore del controllo.

[in, optional] pUserSid

Puntatore all'identificatore di sicurezza (SID) che verrà elencato come origine del controllo nel registro eventi.

[in] dwCount

Numero di coppie di tipo/valore AuditParamFlag visualizzate nella sezione argomenti variabile che segue questo parametro.

...

Elenco di coppie di tipo/valore AuditParamFlag che forniscono informazioni aggiuntive sull'evento.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per informazioni sugli errori estesi, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione authz.h
Libreria Authz.lib
DLL Authz.dll
Componente ridistribuibile Windows Server 2003 Administration Tools Pack in Windows XP

Vedi anche

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams