Funzione AuthzInitializeObjectAccessAuditEvent2 (authz.h)

Articolo
02/26/2024

La funzione AuthzInitializeObjectAccessAuditEvent2 alloca e inizializza un handle AUTHZ_AUDIT_EVENT_HANDLE da usare con la funzione AuthzAccessCheck .

Sintassi

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

Parametri

[in] Flags

Contrassegni che modificano il comportamento del controllo. Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
AUTHZ_NO_ALLOC_STRINGS	Usa 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.
AUTHZ_NO_FAILURE_AUDIT	Disabilita la generazione di controlli di errore.
AUTHZ_NO_SUCCESS_AUDIT	Disabilita la generazione di controlli di esito positivo.

[in] hAuditEventType

Riservato. Questo parametro deve essere impostato su NULL.

[in] szOperationType

Puntatore a una stringa che indica l'operazione da controllare.

[in] szObjectType

Puntatore a una stringa che indica il tipo di oggetto a cui è stato eseguito l'accesso.

[in] szObjectName

Puntatore a una stringa che indica il nome dell'oggetto a cui è stato eseguito l'accesso.

[in] szAdditionalInfo

Puntatore a una stringa definita dalla Resource Manager contenente informazioni di controllo aggiuntive.

[in] szAdditionalInfo2

Puntatore a una stringa definita dalla Resource Manager contenente informazioni di controllo aggiuntive.

[out] phAuditEvent

Puntatore all'handle AUTHZ_AUDIT_EVENT_HANDLE restituito.

[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	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

AuthzAccessCheck

Funzioni di base Controllo di accesso

Condividi tramite