Função InitializeSecurityDescriptor (securitybaseapi.h)

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

Confira também

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Controle de Acesso de baixo nível

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

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl