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