Funzione AuthzInitializeObjectAccessAuditEvent (authz.h)

Articolo
02/26/2024

La funzione AuthzInitializeObjectAccessAuditEvent inizializza il controllo per un oggetto.

Sintassi

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

Parametri

[in] Flags

Modifica il controllo. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
AUTHZ_NO_SUCCESS_AUDIT	Disabilitare la generazione di controlli di esito positivo.
AUTHZ_NO_FAILURE_AUDIT	Disabilitare la generazione di controlli di errore.
AUTHZ_NO_ALLOC_STRINGS	Usare puntatori alle stringhe passate anziché allocare memoria e copiare le stringhe. L'applicazione chiamante deve assicurarsi che la memoria passata rimanga valida durante i controlli di accesso.

[in] hAuditEventType

Riservato. Questo parametro deve essere impostato su NULL.

[in] szOperationType

Stringa che indica l'operazione da controllare.

[in] szObjectType

Stringa che indica il tipo di oggetto a cui si accede.

[in] szObjectName

Stringa indica il nome dell'oggetto a cui si accede.

[in] szAdditionalInfo

Stringa, definita dal Resource Manager, per ulteriori informazioni di controllo.

[out] phAuditEvent

Puntatore che riceve una struttura AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

Deve essere impostato su zero.

...

Parametri aggiuntivi.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
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

AuthzAccessCheck

Funzioni di base Controllo di accesso

Condividi tramite