Compartilhar via


Função SetFileSecurityW (securitybaseapi.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 SetFileSecurityW(
  [in] LPCWSTR              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 securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

GetFileSecurity
Controle de Acesso de baixo nível
Funções de Controle de Acesso de baixo nível
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetKernelObjectSecurity
SetNamedSecurityInfoSetPrivateObjectSecurity
SetUserObjectSecurity