IKnownFolderManager::RegisterFolder 메서드(shobjidl_core.h)
레지스트리에 알려진 새 폴더를 추가합니다. 알려진 폴더 시스템에 자체 폴더 중 하나를 추가하는 ISV(독립 소프트웨어 공급업체)에서 특히 사용됩니다.
구문
HRESULT RegisterFolder(
[in] REFKNOWNFOLDERID rfid,
[in] const KNOWNFOLDER_DEFINITION *pKFD
);
매개 변수
[in] rfid
형식: REFKNOWNFOLDERID
알려진 폴더를 나타내는 GUID 입니다.
[in] pKFD
형식: const KNOWNFOLDER_DEFINITION*
새 폴더의 세부 정보를 제공하는 유효한 KNOWNFOLDER_DEFINITION 구조체에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
참고 이 메서드는 HKEY_LOCAL_MACHINE 업데이트하므로 관리자의 컨텍스트에서 실행해야 합니다. 알려진 폴더를 등록하거나 등록 취소하려면 설치 프로그램에 관리자 권한이 필요합니다.
동일한 파일 시스템 경로에 대한 여러 KNOWNFOLDERID 값은 폴더에 표시할 언어 또는 속성에 대한 혼동을 야기하는 Desktop.ini 파일의 충돌과 같은 몇 가지 문제를 일으킬 수 있습니다. 여러 KNOWNFOLDERID 값은 주소 표시줄 경로 또는 Windows Explorer 폴더에 대해 표시할 작업에 대한 혼동을 일으킬 수도 있습니다.
알려진 폴더의 속성 창 사용자 지정 페이지의 표시를 표시하지 않을 수 있습니다. 이렇게 하려면 다음 레지스트리 REG_DWORD 값을 설정합니다.
HKEY_LOCAL_MACHINE Software Microsoft Windows CurrentVersion Explorer FolderDescriptions Folder GUID PropertyBag NoCustomize = 0x00000001 (1)
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shobjidl_core.h(Shobjidl.h 포함) |
| DLL | Shell32.dll |