ICategoryProvider::GetDefaultCategory メソッド (shobjidl_core.h)

フォルダーが既定のグループ化をオーバーライドできるようにします。

構文

HRESULT GetDefaultCategory(
  [out] GUID       *pguid,
  [out] SHCOLUMNID *pscid
);

パラメーター

[out] pguid

型: GUID*

使用されていません。

[out] pscid

種類: SHCOLUMNID*

このメソッドが戻るときに、 SHCOLUMNID 構造体へのポインターを格納します。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。

リターン コード	説明
S_FALSE	既定のグループはありません。

注釈

ICategoryProvider::GetDefaultCategory は、既定のカテゴライザーで使用される SHCOLUMNID 構造体を返します。 既定のグループがサポートされていない場合、メソッドはS_FALSEを返します。

ICategoryProvider::GetDefaultCategory は、フォルダーが最初に開かれたときにのみ呼び出されます。 その後、ユーザーのグループ化の選択は、ビューの状態を格納する プロパティ バッグ にキャッシュされます。 フォルダーを最初に開いた後に ICategoryProvider::GetDefaultCategory を強制的に呼び出すには、Shell レジストリ キーと ShellNoRoam レジストリ キーを削除する必要があります。 これらは次の場所にあります。

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            Shell
            ShellNoRoam

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll