Funzione AuthzInitializeObjectAccessAuditEvent (authz.h)

  • Articolo

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