Função InitializeSecurityDescriptor (securitybaseapi.h)

Artigo
08/25/2023

A função InitializeSecurityDescriptor inicializa um novo descritor de segurança.

Sintaxe

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

Parâmetros

[out] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que a função inicializa.

[in] dwRevision

O nível de revisão a ser atribuído ao descritor de segurança. Esse parâmetro deve ser SECURITY_DESCRIPTOR_REVISION.

Valor retornado

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.

Comentários

A função InitializeSecurityDescriptor inicializa um descritor de segurança em formato absoluto , em vez de um formato auto-relativo .

A função InitializeSecurityDescriptor inicializa um descritor de segurança para não ter nenhuma SACL ( lista de controle de acesso do sistema ), nenhuma DACL (lista de controle de acesso discricionário ), nenhum proprietário, nenhum grupo primário e todos os sinalizadores de controle definidos como FALSE (NULL). Portanto, exceto pelo nível de revisão, ele está vazio.

Exemplos

Para obter um exemplo que usa essa função, consulte Criando um descritor de segurança para um novo objeto.

Requisitos


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