Função RtlGetGroupSecurityDescriptor (ntifs.h)
A rotina RtlGetGroupSecurityDescriptor retorna as informações do grupo primário para um determinado descritor de segurança.
Sintaxe
NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR SecurityDescriptor,
[out] PSID *Group,
[out] PBOOLEAN GroupDefaulted
);
Parâmetros
[in] SecurityDescriptor
Ponteiro para o descritor de segurança cujas informações do grupo primário devem ser retornadas.
[out] Group
Ponteiro para uma variável que recebe um ponteiro para o SID (identificador de segurança) para o grupo primário. Se o descritor de segurança não contiver um grupo primário, *Group receberá NULL.
[out] GroupDefaulted
Ponteiro para uma variável booliana que recebe o valor do sinalizador SE_GROUP_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL do descritor de segurança. Esse valor só será válido se *Group receber um valor não NULL .
Retornar valor
RtlGetGroupSecurityDescriptor retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:
| Código de retorno | Descrição |
|---|---|
|
O nível de revisão do descritor de segurança não é conhecido ou não tem suporte. Este é um código de erro. |
Comentários
Se o descritor de segurança apontado por SecurityDescriptor contiver um grupo primário, RtlGetGroupSecurityDescriptor definirá o ponteiro apontado por Group para o endereço do SID de grupo do descritor de segurança e definirá a variável apontada por GroupDefaulted como um valor válido.
Se o descritor de segurança apontado por SecurityDescriptor não contiver um grupo primário, RtlGetGroupSecurityDescriptor definirá o ponteiro apontado por Group como NULL e ignorará o parâmetro de saída restante, GroupDefaulted.
Para definir as informações do grupo primário para um descritor de segurança, use RtlSetGroupSecurityDescriptor.
Para recuperar as informações de proprietário de um descritor de segurança, use RtlGetOwnerSecurityDescriptor.
Para obter mais informações sobre segurança e controle de acesso, consulte a documentação do SDK do Microsoft Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Server 2003 SP1 |
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |