IKnownFolderManager::RegisterFolder メソッド (shobjidl_core.h)

  • [アーティクル]

レジストリに新しい既知のフォルダーを追加します。 特に、既知のフォルダー システムに独自のフォルダーの 1 つを追加している独立系ソフトウェア ベンダー (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

既知のフォルダーのサンプル