Share via

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

  • 아티클

새 액세스 권한 목록을 개체의 기존 액세스 권한과 병합합니다.

구문

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

매개 변수

[in] pAccessList

개체에 대한 액세스 목록 배열을 포함하는 ACTRL_ACCESS 구조체에 대한 포인터입니다.

반환 값

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

설명

새 액세스 권한 목록을 기존 액세스 권한과 병합하면 개체에 표시된 액세스 권한 이상이 있어야 합니다. 이 병합 프로세스는 이전의 거부된 액세스 권한 앞에 새 거부된 액세스 권한을 추가하고 기존 허용 권한 앞에 허용되는 새 액세스 권한을 추가하는 것으로 구성됩니다. 기존 권한은 제거되지 않습니다.

병합 후 개체에 대한 액세스 권한은 다음과 같이 정렬됩니다.

  1. [새 액세스 거부]
  2. [이전 액세스 거부]
  3. [새 액세스 허용]
  4. [이전 액세스 허용]
[ACTRL_ACCESS](.의 시스템 제공 구현입니다. /accctrl/ns-accctrl-explicit_access_a.md) 구조체는 1로 설정됩니다. 또한 액세스 항목 목록이 개체 자체에 적용되도록 나타내려면 ACTRL_PROPERTY_ENTRYW 구조체의 lpProperty 멤버가 NULL이어야 합니다.

요구 사항

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

추가 정보

IAccessControl