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
Controle de Acesso de baixo nível