Directory.GetAccessControl Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna a ACL (lista de controle de acesso) do Windows para um diretório.
Sobrecargas
GetAccessControl(String) |
Obtém um objeto DirectorySecurity que encapsula as entradas de ACL (lista de controle de acesso) para um diretório especificado. |
GetAccessControl(String, AccessControlSections) |
Obtém um objeto DirectorySecurity que encapsula o tipo especificado de entradas acl (lista de controle de acesso) para um diretório especificado. |
GetAccessControl(String)
Obtém um objeto DirectorySecurity que encapsula as entradas de ACL (lista de controle de acesso) para um diretório especificado.
public:
static System::Security::AccessControl::DirectorySecurity ^ GetAccessControl(System::String ^ path);
public static System.Security.AccessControl.DirectorySecurity GetAccessControl (string path);
static member GetAccessControl : string -> System.Security.AccessControl.DirectorySecurity
Public Shared Function GetAccessControl (path As String) As DirectorySecurity
Parâmetros
- path
- String
O caminho para um diretório que contém um objeto DirectorySecurity que descreve as informações da ACL (lista de controle de acesso) do arquivo.
Retornos
Um objeto que encapsula as regras de controle de acesso para o arquivo descrito pelo parâmetro path
.
Exceções
O parâmetro path
é null
.
Ocorreu um erro de E/S ao abrir o diretório.
Não foi possível encontrar um erro no nível do sistema, como o diretório. A exceção específica pode ser uma subclasse de SystemException.
O parâmetro path
especificou um diretório somente leitura.
-ou-
Não há suporte para essa operação na plataforma atual.
-ou-
O chamador não tem a permissão necessária.
Comentários
Use o método GetAccessControl para recuperar as entradas de ACL (lista de controle de acesso) para um diretório.
Uma ACL descreve indivíduos e grupos que têm, ou não têm, direitos a ações específicas no arquivo ou diretório especificado. Para obter mais informações, consulte Como adicionar ou remover entradas de lista de controle de acesso.
Em ambientes NTFS, ReadAttributes e ReadExtendedAttributes serão concedidos ao usuário se o usuário tiver direitos de ListDirectory na pasta pai. Para negar ReadAttributes e ReadExtendedAttributes, negue ListDirectory no diretório pai.
Aplica-se a
GetAccessControl(String, AccessControlSections)
Obtém um objeto DirectorySecurity que encapsula o tipo especificado de entradas acl (lista de controle de acesso) para um diretório especificado.
public:
static System::Security::AccessControl::DirectorySecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);
public static System.Security.AccessControl.DirectorySecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);
static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.DirectorySecurity
Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As DirectorySecurity
Parâmetros
- path
- String
O caminho para um diretório que contém um objeto DirectorySecurity que descreve as informações da ACL (lista de controle de acesso) do arquivo.
- includeSections
- AccessControlSections
Um dos valores de AccessControlSections que especifica o tipo de informações de ACL (lista de controle de acesso) a serem recebidas.
Retornos
Um objeto que encapsula as regras de controle de acesso para o arquivo descrito pelo parâmetro path
.
Exceções
O parâmetro path
é null
.
Ocorreu um erro de E/S ao abrir o diretório.
Não foi possível encontrar um erro no nível do sistema, como o diretório. A exceção específica pode ser uma subclasse de SystemException.
O parâmetro path
especificou um diretório somente leitura.
-ou-
Não há suporte para essa operação na plataforma atual.
-ou-
O chamador não tem a permissão necessária.
Comentários
Use o método GetAccessControl para recuperar as entradas de ACL (lista de controle de acesso) para um diretório.
Uma ACL descreve indivíduos e grupos que têm, ou não têm, direitos a ações específicas no arquivo ou diretório especificado. Para obter mais informações, consulte Como adicionar ou remover entradas de lista de controle de acesso.
Em ambientes NTFS, ReadAttributes e ReadExtendedAttributes serão concedidos ao usuário se o usuário tiver direitos de ListDirectory na pasta pai. Para negar ReadAttributes e ReadExtendedAttributes, negue ListDirectory no diretório pai.