File.GetAccessControl 메서드

정의

네임스페이스:

System.IO

어셈블리:

mscorlib.dll

지정된 파일에 대한 ACL(액세스 제어 목록) 항목을 캡슐화하는 FileSecurity 개체를 가져옵니다.

오버로드

GetAccessControl(String)	지정된 파일에 대한 ACL(액세스 제어 목록) 항목을 캡슐화하는 FileSecurity 개체를 가져옵니다.
GetAccessControl(String, AccessControlSections)	특정 파일에 대해 지정된 형식의 ACL(액세스 제어 목록) 항목을 캡슐화하는 FileSecurity 개체를 가져옵니다.

GetAccessControl(String)

지정된 파일에 대한 ACL(액세스 제어 목록) 항목을 캡슐화하는 FileSecurity 개체를 가져옵니다.

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

매개 변수

path

String

파일의 ACL(액세스 제어 목록) 정보를 설명하는 FileSecurity 개체가 포함된 파일의 경로입니다.

반환

FileSecurity

path 매개 변수에서 설명하는 파일에 대한 액세스 제어 규칙을 캡슐화하는 FileSecurity 개체입니다.

예외

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

SEHException

path 매개 변수가 null.

SystemException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

path 매개 변수는 읽기 전용인 파일을 지정했습니다.

-또는-

이 작업은 현재 플랫폼에서 지원되지 않습니다.

-또는-

path 매개 변수는 디렉터리를 지정했습니다.

-또는-

호출자에게 필요한 권한이 없습니다.

설명

GetAccessControl 메서드를 사용하여 파일에 대한 ACL(액세스 제어 목록) 항목을 검색합니다.

ACL은 지정된 파일에 대한 특정 작업에 대한 권한이 있거나 없는 개인 및 그룹에 대해 설명합니다. 자세한 내용은 방법: 액세스 제어 목록 항목 추가 또는 제거참조하세요.

NTFS 환경에서는 사용자가 부모 폴더에 대한 ListDirectory 권한이 있는 경우 사용자에게 ReadAttributes 및 ReadExtendedAttributes 부여됩니다. ReadAttributes 및 ReadExtendedAttributes거부하려면 부모 디렉터리에서 ListDirectory 거부합니다.

GetAccessControl(String, AccessControlSections)

특정 파일에 대해 지정된 형식의 ACL(액세스 제어 목록) 항목을 캡슐화하는 FileSecurity 개체를 가져옵니다.

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

매개 변수

path

String

파일의 ACL(액세스 제어 목록) 정보를 설명하는 FileSecurity 개체가 포함된 파일의 경로입니다.

includeSections

AccessControlSections

받을 ACL(액세스 제어 목록) 정보의 유형을 지정하는 AccessControlSections 값 중 하나입니다.

반환

FileSecurity

path 매개 변수에서 설명하는 파일에 대한 액세스 제어 규칙을 캡슐화하는 FileSecurity 개체입니다.

예외

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

SEHException

path 매개 변수가 null.

SystemException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

path 매개 변수는 읽기 전용인 파일을 지정했습니다.

-또는-

이 작업은 현재 플랫폼에서 지원되지 않습니다.

-또는-

path 매개 변수는 디렉터리를 지정했습니다.

-또는-

호출자에게 필요한 권한이 없습니다.

설명

GetAccessControl 메서드를 사용하여 파일에 대한 ACL(액세스 제어 목록) 항목을 검색합니다.

ACL은 지정된 파일에 대한 특정 작업에 대한 권한이 있거나 없는 개인 및 그룹에 대해 설명합니다. 자세한 내용은 방법: 액세스 제어 목록 항목 추가 또는 제거참조하세요.

NTFS 환경에서는 사용자가 부모 폴더에 대한 ListDirectory 권한이 있는 경우 사용자에게 ReadAttributes 및 ReadExtendedAttributes 부여됩니다. ReadAttributes 및 ReadExtendedAttributes거부하려면 부모 디렉터리에서 ListDirectory 거부합니다.