IAccessControl::IsAccessAllowed 메서드(iaccess.h)

지정한 트러스티에 개체 또는 속성에 대한 액세스 권한이 있는지 여부를 확인합니다.

구문

HRESULT IsAccessAllowed(
  [in]  PTRUSTEEW     pTrustee,
  [in]  LPWSTR        lpProperty,
  [in]  ACCESS_RIGHTS AccessRights,
  [out] BOOL          *pfAccessAllowed
);

매개 변수

[in] pTrustee

TRUSTEE 구조체에 대한 포인터입니다.

[in] lpProperty

속성의 이름입니다. IAccessControl의 COM 구현을 사용하는 경우 이 매개 변수는 NULL이어야 합니다.

[in] AccessRights

개체에 대한 액세스 권한입니다. IAccessControl의 COM 구현을 사용하는 경우 이 값은 0 또는 1(COM_RIGHTS_EXECUTE)이어야 합니다.

[out] pfAccessAllowed

액세스가 허용되는지 여부를 나타냅니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

시스템 제공 IAccessControl(CLSID_DCOMAccessControl) 구현에서 IsAccessAllowed는 분산 COM 호출 중에만 호출할 수 있으며 유효한 수탁자 이름은 클라이언트 이름뿐입니다.

다음 표에서는 IAccessControl의 디렉터리 서비스 및 스토리지 구현에 사용되는 개체별 액세스 권한을 나열합니다.

다음 권한은 DS 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_DS_OPEN	DS 개체 열기
ACTRL_DS_CREATE_CHILD	자식 개체 만들기
ACTRL_DS_DELETE_CHILD	자식 개체 삭제
ACTRL_DS_LIST	개체 열거
ACTRL_DS_SELF	트러스티와 관련된 멤버 목록 업데이트
ACTRL_DS_READ_PROP	속성 읽기
ACTRL_DS_WRITE_PROP	속성 쓰기

 

다음 권한은 파일 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_FILE_READ	파일에서 읽습니다.
ACTRL_FILE_WRITE	파일에 쓰기
ACTRL_FILE_APPEND	파일에 추가
ACTRL_FILE_READ_PROP	파일 속성 또는 확장 특성 읽기
ACTRL_FILE_WRITE_PROP	파일 속성 또는 확장 특성 쓰기
ACTRL_FILE_EXECUTE	파일 실행
ACTRL_FILE_READ_ATTRIB	파일 특성 읽기
ACTRL_FILE_WRITE_ATTRIB	파일 특성 작성

 

다음 권한은 디렉터리 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_DIR_LIST	디렉터리의 내용 나열
ACTRL_DIR_CREATE_OBJECT	디렉터리에 자식 개체(파일) 만들기
ACTRL_DIR_CREATE_CHILD	하위 디렉터리 만들기
ACTRL_DIR_DELETE_CHILD	하위 디렉터리 삭제
ACTRL_DIR_TRAVERSE	디렉터리 트래버스

 

다음 권한은 커널 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_KERNEL_TERMINATE	프로세스 또는 스레드 종료
ACTRL_KERNEL_THREAD	스레드 만들기
ACTRL_KERNEL_VM	주소 공간 작업 수행
ACTRL_KERNEL_VM_READ	메모리에서 읽기
ACTRL_KERNEL_VM_WRITE	메모리에 쓰기
ACTRL_KERNEL_DUP_HANDLE	핸들 복제
ACTRL_KERNEL_PROCESS	프로세스 만들기
ACTRL_KERNEL_SET_INFO	커널 개체 정보 또는 상태 가져오기
ACTRL_KERNEL_GET_INFO	커널 개체 정보 또는 상태 설정
ACTRL_KERNEL_CONTROL	커널 개체 제어(예: 스레드 일시 중단)
ACTRL_KERNEL_ALERT	커널 개체에 경고합니다.
ACTRL_KERNEL_GET_CONTEXT	스레드 컨텍스트 가져오기
ACTRL_KERNEL_SET_CONTEXT	스레드 컨텍스트 설정
ACTRL_KERNEL_TOKEN	스레드 토큰 설정
ACTRL_KERNEL_IMPERSONATE	클라이언트 가장
ACTRL_KERNEL_DIMPERSONATE	클라이언트를 직접 가장

 

다음 사용 권한은 프린터 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_PRINT_SADMIN	인쇄 서버 관리
ACTRL_PRINT_SLIST	인쇄 서버 열거
ACTRL_PRINT_PADMIN	프린터 관리
ACTRL_PRINT_PUSE	프린터 사용
ACTRL_PRINT_JADMIN	인쇄 작업 관리

 

다음 권한은 서비스 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_SVC_GET_INFO	서비스 시작
ACTRL_SVC_SET_INFO	서비스 중지
ACTRL_SVC_STATUS	서비스 일시 중지
ACTRL_SVC_LIST	서비스 열거
ACTRL_SVC_START	서비스 시작
ACTRL_SVC_STOP	서비스 중지
ACTRL_SVC_PAUSE	서비스 일시 중지
ACTRL_SVC_INTERROGATE	현재 상태 대한 서비스 쿼리
ACTRL_SVC_UCONTROL	사용자 정의 컨트롤

 

다음 권한은 레지스트리 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_REG_QUERY	레지스트리 하위 키 읽기
ACTRL_REG_SET	레지스트리 하위 키 작성
ACTRL_REG_CREATE_CHILD	레지스트리 하위 키 만들기
ACTRL_REG_LIST	레지스트리 하위 키 열거
ACTRL_REG_NOTIFY	레지스트리 알림 만들기
ACTRL_REG_LINK	바로 가기 링크 만들기

 

다음 권한은 창 개체와 관련이 있습니다.

액세스 권한	Description
ACTRL_WIN_CLIPBRD	클립보드에 대한 액세스 사용
ACTRL_WIN_GLOBAL_ATOMS	전역 원자 액세스 사용
ACTRL_WIN_CREATE	데스크톱 액세스 만들기
ACTRL_WIN_LIST_DESK	데스크톱 열거
ACTRL_WIN_LIST	창 스테이션 열거
ACTRL_WIN_READ_ATTRIBS	특성 읽기
ACTRL_WIN_WRITE_ATTRIBS	특성 작성
ACTRL_WIN_SCREEN	화면에 대한 액세스 사용
ACTRL_WIN_EXIT	ExitWindows 또는 ExitWindowsEx 호출

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	iaccess.h

추가 정보

IAccessControl