IAccessControl::GetAllAccessRights 메서드(iaccess.h)
지정된 개체에 대한 액세스 권한 및/또는 소유자 및 그룹의 전체 목록을 가져옵니다.
구문
HRESULT GetAllAccessRights(
[in] LPWSTR lpProperty,
[out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
[out] PTRUSTEEW *ppOwner,
[out] PTRUSTEEW *ppGroup
);
매개 변수
[in] lpProperty
속성의 이름입니다. IAccessControl의 COM 구현을 사용하는 경우 이 매개 변수는 NULL이어야 합니다.
[out] ppAccessList
액세스 목록 구조에 대한 포인터를 수신하는 포인터 변수의 주소입니다. 이 매개 변수는 ACTRL_ACCESS 수 없습니다.
호출이 성공하면 호출자는 CoTaskMemFree 함수를 사용하여 할당된 메모리를 해제해야 합니다. 메모리는 allocate(all_nodes)입니다. 즉, 모든 하위 구조가 한 블록에 할당됩니다. 따라서 CoTaskMemFree에 대한 단일 호출을 통해 전체 데이터 구조를 해제해야 합니다.
[out] ppOwner
소유자 정보를 수신하는 TRUSTEE 구조체에 대한 포인터입니다. 이 매개 변수가 NULL 이 아니고 함수가 성공하면 호출자는 CoTaskMemFree를 사용하여 메모리를 해제해야 합니다.
[out] ppGroup
그룹 정보를 수신하는 TRUSTEE 구조체에 대한 포인터입니다. 이 매개 변수가 NULL 이 아니고 함수가 성공하면 호출자는 CoTaskMemFree를 사용하여 메모리를 해제해야 합니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | iaccess.h |