Compartilhar via


Função GetSecurityDescriptorGroup (securitybaseapi.h)

A função GetSecurityDescriptorGroup recupera as informações do grupo primário de um descritor de segurança.

Sintaxe

BOOL GetSecurityDescriptorGroup(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pGroup,
  [out] LPBOOL               lpbGroupDefaulted
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR cujo grupo primário informa que a função recupera.

[out] pGroup

Um ponteiro para um ponteiro para um SID ( identificador de segurança ) que identifica o grupo primário quando a função retorna. Se o descritor de segurança não contiver um grupo primário, a função definirá o ponteiro apontado por pGroup como NULL e ignorará o parâmetro de saída restante, lpbGroupDefaulted. Se o descritor de segurança contiver um grupo primário, a função definirá o ponteiro apontado por pGroup para o endereço do SID do grupo do descritor de segurança e fornecerá um valor válido para a variável apontada por lpbGroupDefaulted.

[out] lpbGroupDefaulted

Um ponteiro para um sinalizador que é definido como o valor do sinalizador SE_GROUP_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL quando a função retorna. Se o valor armazenado na variável apontada pelo parâmetro pGroup for NULL, nenhum valor será definido.

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorGroup