Compartilhar via

Função LsaAddAccountRights (ntsecapi.h)

  • Artigo

A função LsaAddAccountRights atribui um ou mais privilégios a uma conta. Se a conta não existir, LsaAddAccountRights a criará.

Sintaxe

NTSTATUS LsaAddAccountRights(
  [in] LSA_HANDLE          PolicyHandle,
  [in] PSID                AccountSid,
  [in] PLSA_UNICODE_STRING UserRights,
  [in] ULONG               CountOfRights
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . O identificador deve ter o acesso de POLICY_LOOKUP_NAMES correto. Se a conta identificada pelo parâmetro AccountSid não existir, o identificador deverá ter o POLICY_CREATE_ACCOUNT direito de acesso. Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] AccountSid

Ponteiro para o SID da conta à qual a função atribui privilégios.

[in] UserRights

Ponteiro para uma matriz de estruturas de LSA_UNICODE_STRING . Cada estrutura contém o nome de um privilégio a ser adicionado à conta. Para obter uma lista de nomes de privilégio, consulte Constantes de privilégios.

[in] CountOfRights

Especifica o número de elementos na matriz UserRights .

Retornar valor

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

Se a função falhar, o valor retornado será um código NTSTATUS, que pode ser o valor a seguir ou um dos valores retornados da função de política LSA.

Código de retorno Descrição
STATUS_NO_SUCH_PRIVILEGE
 Um dos nomes de privilégio não é válido.
 

Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

Comentários

Se você especificar privilégios já concedidos à conta, eles serão ignorados.

Para obter um exemplo que demonstra como chamar essa função, consulte Gerenciando permissões de conta.

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 ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

LSA_UNICODE_STRING

LsaEnumerateAccountRights

LsaRemoveAccountRights