Compartilhar via


Função PrivilegedServiceAuditAlarmW (securitybaseapi.h)

A função PrivilegedServiceAuditAlarm gera uma mensagem de auditoria no log de eventos de segurança. Um servidor protegido pode usar essa função para registrar tentativas de um cliente de usar um conjunto de privilégios especificado.

No momento, não há suporte para alarmes.

Sintaxe

BOOL PrivilegedServiceAuditAlarmW(
  [in] LPCWSTR        SubsystemName,
  [in] LPCWSTR        ServiceName,
  [in] HANDLE         ClientToken,
  [in] PPRIVILEGE_SET Privileges,
  [in] BOOL           AccessGranted
);

Parâmetros

[in] SubsystemName

Um ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome do subsistema que chama a função. Essas informações aparecem no registro de log de eventos de segurança.

[in] ServiceName

Um ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome do serviço de subsistema privilegiado. Essas informações aparecem no registro de log de eventos de segurança.

[in] ClientToken

Identifica um token de acesso que representa o cliente que solicitou a operação. Esse identificador deve ter sido obtido abrindo o token de um thread representando o cliente. O token deve estar aberto para acesso TOKEN_QUERY. A função usa esse token para obter a identidade do cliente para o registro de log de eventos de segurança.

[in] Privileges

Um ponteiro para uma estrutura PRIVILEGE_SET que contém os privilégios que o cliente tentou usar. Os nomes dos privilégios aparecem no registro de log de eventos de segurança.

[in] AccessGranted

Indica se a tentativa do cliente de usar os privilégios foi bem-sucedida. Se esse valor for TRUE, o registro de log de eventos de segurança indicará êxito. Se esse valor for FALSE, o registro do log de eventos de segurança indicará falha.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função PrivilegedServiceAuditAlarm não marcar o token de acesso do cliente para determinar se os privilégios são mantidos ou habilitados. Normalmente, primeiro você chama a função PrivilegeCheck para determinar se os privilégios especificados estão habilitados no token de acesso e, em seguida, chama PrivilegedServiceAuditAlarm para registrar os resultados.

A função PrivilegedServiceAuditAlarm requer que o processo de chamada tenha SE_AUDIT_NAME privilégio habilitado. O teste para esse privilégio sempre é executado no token primário do processo de chamada. Isso permite que o processo de chamada represente um cliente durante a chamada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Funções de Controle de Acesso cliente/servidor
Visão geral do Controle de Acesso cliente/servidor
ObjectPrivilegeAuditAlarm
PRIVILEGE_SET
Privilegecheck