Função RtlGetGroupSecurityDescriptor (ntifs.h)

Artigo
02/07/2025

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 identificador de segurança (SID) para o grupo primário. Se o descritor de segurança não contiver um grupo primário, * de grupo receberá NULL.

[out] GroupDefaulted

Ponteiro para uma variável booliana que recebe o valor do sinalizador SE_GROUP_DEFAULTED na estrutura de SECURITY_DESCRIPTOR_CONTROL do descritor de segurança. Esse valor será válido somente se * de grupo receber um valorNULL não.

Valor de retorno

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.

Observações

Se o descritor de segurança apontado pelo SecurityDescriptor contiver um grupo primário, RtlGetGroupSecurityDescriptor definirá o ponteiro apontado por Group para o endereço do SID do grupo do descritor de segurança e definirá a variável apontada por GroupDefaulted para um valor válido.

Se o descritor de segurança apontado pelo SecurityDescriptor não contiver um grupo primário, RtlGetGroupSecurityDescriptor definirá o ponteiro apontado por Group para 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
de cliente com suporte mínimo	Windows Server 2003 SP1
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

rtlGetOwnerSecurityDescriptor

rtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID

Partilhar via