Função SetFileSecurityA (winbase.h)
A função SetFileSecurity define a segurança de um arquivo ou objeto de diretório.
Essa função está obsoleta. Em vez disso, use a função SetNamedSecurityInfo .
Sintaxe
BOOL SetFileSecurityA(
[in] LPCSTR lpFileName,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parâmetros
[in] lpFileName
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o arquivo ou diretório para o qual a segurança está definida. Observe que a segurança aplicada a um diretório não é herdada por seus filhos.
[in] SecurityInformation
Especifica uma estrutura SECURITY_INFORMATION que identifica o conteúdo do descritor de segurança apontado pelo parâmetro pSecurityDescriptor .
[in] pSecurityDescriptor
Um ponteiro para uma estrutura SECURITY_DESCRIPTOR .
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.
Comentários
A função SetFileSecurity só será bem-sucedida se as seguintes condições forem atendidas:
- Se o proprietário do objeto estiver sendo definido, o processo de chamada deverá ter WRITE_OWNER permissão ou ser o proprietário do objeto.
- Se a DACL ( lista de controle de acesso discricionário ) do objeto estiver sendo definida, o processo de chamada deverá ter WRITE_DAC permissão ou ser o proprietário do objeto.
- Se a SACL ( lista de controle de acesso do sistema ) do objeto estiver sendo definida, o privilégio SE_SECURITY_NAME deverá ser habilitado para o processo de chamada.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | winbase.h (incluir Windows.h) |
Biblioteca | Advapi32.lib |
DLL | Advapi32.dll |
Confira também
Controle de Acesso de baixo nível