Função LsaEnumerateAccountRights (ntsecapi.h)

A função LsaEnumerateAccountRights enumera os privilégios atribuídos a uma conta.

Sintaxe

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

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . O identificador deve ter o direito de acesso POLICY_LOOKUP_NAMES. Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] AccountSid

Ponteiro para o SID da conta para a qual enumerar privilégios.

[out] UserRights

Recebe um ponteiro para uma matriz de estruturas LSA_UNICODE_STRING . Cada estrutura contém o nome de um privilégio mantido pela conta. Para obter uma lista de nomes de privilégios, consulte Constantes de privilégio

Quando você não precisar mais das informações, passe o ponteiro retornado para LsaFreeMemory.

[out] CountOfRights

Ponteiro para uma variável que recebe o número de privilégios na matriz UserRights .

Retornar valor

Se pelo menos um direito de conta for encontrado, a função terá êxito e retornará STATUS_SUCCESS.

Se nenhum direito de conta for encontrado ou se a função falhar por qualquer outro motivo, a função retornará um código NTSTATUS, como FILE_NOT_FOUND. Para obter mais informações, consulte Valores retornados da função de política LSA. Use a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

Requisitos

Confira também

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights