Função GetSecurityDescriptorGroup (securitybaseapi.h)

Artigo
03/05/2024

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