Função SetFileSecurityA (winbase.h)

Artigo
03/13/2024

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