Función LsaEnumerateAccountRights (ntsecapi.h)

La función LsaEnumerateAccountRights enumera los privilegios asignados a una cuenta.

Sintaxis

NTSTATUS LsaEnumerateAccountRights(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PSID                AccountSid,
  [out] PLSA_UNICODE_STRING *UserRights,
  [out] PULONG              CountOfRights
);

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . El identificador debe tener el derecho de acceso POLICY_LOOKUP_NAMES. Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] AccountSid

Puntero al SID de la cuenta para la que se van a enumerar los privilegios.

[out] UserRights

Recibe un puntero a una matriz de estructuras de LSA_UNICODE_STRING . Cada estructura contiene el nombre de un privilegio mantenido por la cuenta. Para obtener una lista de nombres de privilegios, consulte Constantes de privilegios.

Cuando ya no necesite la información, pase el puntero devuelto a LsaFreeMemory.

[out] CountOfRights

Puntero a una variable que recibe el número de privilegios de la matriz UserRights .

Valor devuelto

Si se encuentra al menos un derecho de cuenta, la función se realiza correctamente y devuelve STATUS_SUCCESS.

Si no se encuentran derechos de cuenta o si se produce un error en la función por cualquier otro motivo, la función devuelve un código NTSTATUS, como FILE_NOT_FOUND. Para obtener más información, vea Valores devueltos de la función de directiva LSA. Use la función LsaNtStatusToWinError para convertir el código NTSTATUS en un código de error de Windows.

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

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights