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 업데이트하므로 관리자의 컨텍스트에서 실행해야 합니다. 알려진 폴더를 등록하거나 등록 취소하려면 설치 프로그램에 관리자 권한이 필요합니다.

 

IKnownFolderManager::RegisterFolder는 새 KNOWNFOLDERID가 기존 KNOWNFOLDERID가 이미 가리키는 파일 시스템 경로를 참조하지 않는지 확인하려고 시도합니다. 새 KNOWNFOLDERID 가 발견되면 이 메서드가 실패합니다.

동일한 파일 시스템 경로에 대한 여러 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

추가 정보

IKnownFolderManager

IKnownFolderManager::UnregisterFolder

알려진 폴더 샘플