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
| 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 |