File.GetAccessControl Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un objeto FileSecurity que encapsula las entradas de la lista de control de acceso (ACL) para un archivo especificado.
Sobrecargas
GetAccessControl(String) |
Obtiene un objeto FileSecurity que encapsula las entradas de la lista de control de acceso (ACL) para un archivo especificado. |
GetAccessControl(String, AccessControlSections) |
Obtiene un objeto FileSecurity que encapsula el tipo especificado de entradas de lista de control de acceso (ACL) para un archivo determinado. |
GetAccessControl(String)
Obtiene un objeto FileSecurity que encapsula las entradas de la lista de control de acceso (ACL) para un archivo especificado.
public:
static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);
public static System.Security.AccessControl.FileSecurity GetAccessControl (string path);
static member GetAccessControl : string -> System.Security.AccessControl.FileSecurity
Public Shared Function GetAccessControl (path As String) As FileSecurity
Parámetros
- path
- String
Ruta de acceso a un archivo que contiene un objeto FileSecurity que describe la información de la lista de control de acceso (ACL) del archivo.
Devoluciones
Objeto FileSecurity que encapsula las reglas de control de acceso para el archivo descrito por el parámetro path
.
Excepciones
Error de E/S al abrir el archivo.
El parámetro path
es null
.
No se encontró el archivo.
El parámetro path
especificó un archivo de solo lectura.
-o-
Esta operación no se admite en la plataforma actual.
-o-
El parámetro path
especificó un directorio.
-o-
El autor de la llamada no tiene el permiso necesario.
Comentarios
Use el método GetAccessControl para recuperar las entradas de la lista de control de acceso (ACL) de un archivo.
Una ACL describe individuos y grupos que tienen derechos, o no, a acciones específicas en el archivo especificado. Para obtener más información, vea Cómo: Agregar o quitar entradas de lista de control de acceso.
En entornos NTFS, ReadAttributes y ReadExtendedAttributes se conceden al usuario si el usuario tiene derechos ListDirectory en la carpeta primaria. Para denegar ReadAttributes y ReadExtendedAttributes, deniegue ListDirectory en el directorio primario.
Se aplica a
GetAccessControl(String, AccessControlSections)
Obtiene un objeto FileSecurity que encapsula el tipo especificado de entradas de lista de control de acceso (ACL) para un archivo determinado.
public:
static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);
public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);
static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity
Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity
Parámetros
- path
- String
Ruta de acceso a un archivo que contiene un objeto FileSecurity que describe la información de la lista de control de acceso (ACL) del archivo.
- includeSections
- AccessControlSections
Uno de los valores de AccessControlSections que especifica el tipo de información de lista de control de acceso (ACL) que se va a recibir.
Devoluciones
Objeto FileSecurity que encapsula las reglas de control de acceso para el archivo descrito por el parámetro path
.
Excepciones
Error de E/S al abrir el archivo.
El parámetro path
es null
.
No se encontró el archivo.
El parámetro path
especificó un archivo de solo lectura.
-o-
Esta operación no se admite en la plataforma actual.
-o-
El parámetro path
especificó un directorio.
-o-
El autor de la llamada no tiene el permiso necesario.
Comentarios
Use el método GetAccessControl para recuperar las entradas de la lista de control de acceso (ACL) de un archivo.
Una ACL describe individuos y grupos que tienen derechos, o no, a acciones específicas en el archivo especificado. Para obtener más información, vea Cómo: Agregar o quitar entradas de lista de control de acceso.
En entornos NTFS, ReadAttributes y ReadExtendedAttributes se conceden al usuario si el usuario tiene derechos ListDirectory en la carpeta primaria. Para denegar ReadAttributes y ReadExtendedAttributes, deniegue ListDirectory en el directorio primario.