FileStream.GetAccessControl Method

Definition

Gets a FileSecurity object that encapsulates the access control list (ACL) entries for the file described by the current FileStream object.

public:
 System::Security::AccessControl::FileSecurity ^ GetAccessControl();
public System.Security.AccessControl.FileSecurity GetAccessControl ();
member this.GetAccessControl : unit -> System.Security.AccessControl.FileSecurity
Public Function GetAccessControl () As FileSecurity

Returns

An object that encapsulates the access control settings for the file described by the current FileStream object.

Exceptions

The file is closed.

An I/O error occurred while opening the file.

The file could not be found.

This operation is not supported on the current platform.

-or-

The caller does not have the required permission.

Remarks

While the FileStream class and GetAccessControl can be used to retrieve the access control list (ACL) entries of an existing file, consider using File.GetAccessControl method, as it is easier to use.

Use the GetAccessControl method to retrieve the ACL entries for a file.

An ACL describes individuals and/or groups who have, or do not have, rights to specific actions on the given file. For more information, see How to: Add or Remove Access Control List Entries.

Applies to