Função AuditSetPerUserPolicy (ntsecapi.h)
A função AuditSetPerUserPolicy define a política de auditoria por usuário em uma ou mais subcategorias de auditoria para a entidade de segurança especificada.
Sintaxe
BOOLEAN AuditSetPerUserPolicy(
[in] const PSID pSid,
[in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
[in] ULONG dwPolicyCount
);
Parâmetros
[in] pSid
Um ponteiro para a estrutura sid associada à entidade de segurança para a qual definir a política de auditoria. Atualmente, não há suporte para a política por usuário para SIDs de grupo.
[in] pAuditPolicy
Um ponteiro para uma matriz de estruturas AUDIT_POLICY_INFORMATION . Cada estrutura especifica a política de auditoria por usuário para uma subcategoria de auditoria.
O membro AuditCategoryGuid dessas estruturas é ignorado.
[in] dwPolicyCount
O número de elementos na matriz pAuditPolicy .
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 |
|---|---|
|
O chamador não tem o privilégio ou os direitos de acesso necessários para chamar essa função. |
|
Um ou mais parâmetros são inválidos. |
|
A estrutura SID especificada pelo parâmetro pSID não está associada a um usuário existente. |
Comentários
Para chamar essa função com êxito, o chamador deve ter SeSecurityPrivilege ou ter acesso AUDIT_SET_USER_POLICY 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 |