다음을 통해 공유


File.GetAccessControl 메서드

정의

지정된 파일에 대한 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 개체가 포함된 파일의 경로입니다.

반환

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

예외

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

path 매개 변수가 null.

파일을 찾을 수 없습니다.

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

-또는-

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

-또는-

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

-또는-

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

설명

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

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

NTFS 환경에서는 사용자가 부모 폴더에 대한 ListDirectory 권한이 있는 경우 사용자에게 ReadAttributesReadExtendedAttributes 부여됩니다. ReadAttributesReadExtendedAttributes거부하려면 부모 디렉터리에서 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 값 중 하나입니다.

반환

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

예외

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

path 매개 변수가 null.

파일을 찾을 수 없습니다.

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

-또는-

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

-또는-

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

-또는-

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

설명

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

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

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

적용 대상