IKnownFolder::GetFolderDefinition 메서드(shobjidl_core.h)

폴더의 범주, 이름, 경로, 설명, 도구 설명, 아이콘 및 기타 속성을 포함하는 알려진 폴더의 정의 요소가 포함된 구조를 검색합니다.

구문

HRESULT GetFolderDefinition(
  [out] KNOWNFOLDER_DEFINITION *pKFD
);

매개 변수

[out] pKFD

형식: KNOWNFOLDER_DEFINITION*

이 메서드가 반환되면 KNOWNFOLDER_DEFINITION 구조체에 대한 포인터가 포함됩니다. 더 이상 필요하지 않은 경우 호출 애플리케이션은 FreeKnownFolderDefinitionFields 를 호출하여 이 리소스를 해제합니다.

반환 값

형식: HRESULT

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

설명

타사 애플리케이션이 자체 알려진 폴더를 만들 때 KNOWNFOLDER_DEFINITION 구조로 정의한 다음 시스템에 등록하여 해당 폴더를 만듭니다. 등록된 알려진 폴더 정의 정보(시스템 제공 또는 애플리케이션 생성)는 이 메서드를 통해 검색할 수 있습니다.

이 메서드를 호출하려면 호출자에게 최소한 사용자 권한이 있어야 합니다.

요구 사항

추가 정보

IKnownFolder

알려진 폴더 샘플