Função LsaAddAccountRights (ntsecapi.h)
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 |
|---|---|
|
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 |