Função AuditEnumeratePerUserPolicy (ntsecapi.h)

  • Artigo

A função AuditEnumeratePerUserPolicy enumera os usuários para os quais a política de auditoria por usuário é especificada.

Sintaxe

BOOLEAN AuditEnumeratePerUserPolicy(
  [out] PPOLICY_AUDIT_SID_ARRAY *ppAuditSidArray
);

Parâmetros

[out] ppAuditSidArray

Um ponteiro para um único buffer que contém uma matriz de ponteiros para POLICY_AUDIT_SID_ARRAY estruturas e as próprias estruturas. As estruturas POLICY_AUDIT_SID_ARRAY especificam os usuários para os quais a política de auditoria por usuário é especificada.

Quando terminar de usar esse buffer, libere-o chamando a função AuditFree .

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError. GetLastError pode retornar um dos seguintes códigos de erro definidos em WinError.h.

Valor/código retornado Descrição
ERROR_ACCESS_DENIED
5
 O chamador não tem o privilégio ou os direitos de acesso necessários para chamar essa função.
ERROR_INVALID_PARAMETER
87
 Um ou mais parâmetros são inválidos.

Comentários

Para chamar essa função com êxito, o chamador deve ter SeSecurityPrivilege ou ter acesso AUDIT_ENUMERATE_USERS no objeto de segurança Audit.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll