Função SetSecurityDescriptorGroup (securitybaseapi.h)

Artigo
03/15/2023

A função SetSecurityDescriptorGroup define as informações do grupo primário de um descritor de segurança de formato absoluto, substituindo todas as informações de grupo primário já presentes no descritor de segurança.

Sintaxe

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

Parâmetros

[in, out] pSecurityDescriptor

Um ponteiro para a estrutura SECURITY_DESCRIPTOR cujo grupo primário é definido por essa função. A função substitui qualquer grupo primário existente pelo novo grupo primário.

[in, optional] pGroup

Um ponteiro para uma estrutura SID para o novo grupo primário do descritor de segurança. A estrutura SID é referenciada pelo descritor de segurança, não copiado. Se esse parâmetro for NULL, a função limpará as informações do grupo primário do descritor de segurança. Isso marca o descritor de segurança como não tendo nenhum grupo primário.

[in] bGroupDefaulted

Indica se as informações do grupo primário são derivadas de um mecanismo padrão. Se esse valor for TRUE, serão informações padrão e a função armazenará esse valor como o sinalizador SE_GROUP_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL . Se esse parâmetro for zero, o sinalizador SE_GROUP_DEFAULTED estará limpo.

Valor retornado

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

Se a função falhar, o valor retornado será 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