Función LsaAddAccountRights (ntsecapi.h)

  • Artículo

La función LsaAddAccountRights asigna uno o varios privilegios a una cuenta. Si la cuenta no existe, LsaAddAccountRights la crea.

Sintaxis

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

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . El identificador debe tener el derecho de acceso POLICY_LOOKUP_NAMES. Si la cuenta identificada por el parámetro AccountSid no existe, el identificador debe tener el derecho de acceso POLICY_CREATE_ACCOUNT. Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] AccountSid

Puntero al SID de la cuenta a la que la función asigna privilegios.

[in] UserRights

Puntero a una matriz de estructuras de LSA_UNICODE_STRING . Cada estructura contiene el nombre de un privilegio que se va a agregar a la cuenta. Para obtener una lista de nombres de privilegios, consulte Constantes de privilegios.

[in] CountOfRights

Especifica el número de elementos de la matriz UserRights .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es STATUS_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código NTSTATUS, que puede ser el siguiente valor o uno de los valores devueltos de la función de directiva LSA.

Código devuelto Descripción
STATUS_NO_SUCH_PRIVILEGE
 Uno de los nombres de privilegios no es válido.
 

Puede usar la función LsaNtStatusToWinError para convertir el código NTSTATUS en un código de error de Windows.

Comentarios

Si especifica privilegios ya concedidos a la cuenta, se omiten.

Para ver un ejemplo que muestra cómo llamar a esta función, consulte Administración de permisos de cuenta.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

LSA_UNICODE_STRING

LsaEnumerateAccountRights

LsaRemoveAccountRights