IEffectivePermission::GetEffectivePermission 메서드(aclui.h)

GetEffectivePermission 메서드는 개체 형식에 대한 유효 권한을 반환합니다.

구문

HRESULT GetEffectivePermission(
  [in]  const GUID           *pguidObjectType,
  [in]  PSID                 pUserSid,
  [in]  LPCWSTR              pszServerName,
  [in]  PSECURITY_DESCRIPTOR pSD,
  [out] POBJECT_TYPE_LIST    *ppObjectTypeList,
  [out] ULONG                *pcObjectTypeListLength,
  [out] PACCESS_MASK         *ppGrantedAccessList,
  [out] ULONG                *pcGrantedAccessListLength
);

매개 변수

[in] pguidObjectType

사용 권한을 쿼리하는 개체 형식에 대한 GUID 입니다.

[in] pUserSid

유효 권한이 결정되는 보안 주체를 나타내는 SID 구조체에 대한 포인터입니다.

[in] pszServerName

서버 이름을 나타내는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

[in] pSD

개체의 보안 설명자를 나타내는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 보안 설명자는 액세스 검사 수행하는 데 사용됩니다.

[out] ppObjectTypeList

개체 트리의 개체 형식 배열을 나타내는 OBJECT_TYPE_LIST 구조체에 대한 포인터입니다. 개체가 속성 액세스를 지원하지 않는 경우 다음 기술을 사용하여 OBJECT_TYPE_LIST 값을 지정합니다.

#include <windows.h>

OBJECT_TYPE_LIST g_DefaultOTL[] = {
 {0, 0, (LPGUID)&GUID_NULL},
};

[out] pcObjectTypeListLength

ppObjectTypeList에서 가리키는 개체 형식의 수를 수신하는 ULONG에 대한 포인터입니다.

[out] ppGrantedAccessList

부여된 액세스 마스크의 배열을 수신하는 ACCESS_MASK 대한 포인터입니다. 운영 체제는 LocalFree 를 사용하여 이 매개 변수에 할당된 메모리를 해제합니다.

[out] pcGrantedAccessListLength

ppGrantedAccessList 매개 변수가 가리키는 부여된 액세스 마스크 수를 수신하는 ULONG 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 S_OK.

함수가 실패하면 반환 값은 오류를 나타내는 HRESULT 입니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

요구 사항

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