Função RtlGetGroupSecurityDescriptor (ntifs.h)

  • Artigo

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

Confira também

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID