Share via

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 檔案總管中資料夾要顯示的工作。

您可以隱藏已知資料夾屬性視窗的[自訂] 頁面顯示。 若要這樣做，請設定下列登錄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

已知資料夾範例