AssocGetDetailsOfPropKey 関数 (shlobj_core.h)

名前空間拡張によって提供されるファイル関連付け情報を使用して、特定のプロパティ キーの値を取得します。

構文

SHSTDAPI AssocGetDetailsOfPropKey(
  [in]  IShellFolder      *psf,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  const PROPERTYKEY *pkey,
  [out] VARIANT           *pv,
  [out] BOOL              *pfFoundPropKey
);

パラメーター

[in] psf

種類: IShellFolder*

ファイル関連付けのプロパティ キーの詳細が取得されるシェル フォルダーへのポインター。

[in] pidl

種類: PCUITEMID_CHILD

ファイルの関連付けが要求されている子項目の PIDL。

[in] pkey

型: PROPERTYKEY*

取得するプロパティ キーへのポインター。

[out] pv

型: VARIANT*

この関数から制御が戻るときに、指定されたプロパティ キーの詳細が格納されます。

[out] pfFoundPropKey

種類: BOOL*

この関数が戻るときに、プロパティ キーが見つかった場合は TRUE 、それ以外の場合は FALSE のフラグが含まれます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、 IShellFolder名前空間拡張機能の実装者のみが使用します。 他の呼び出し元アプリケーションでは 、IShellFolder2::GetDetailsEx を使用して PROPERTYKEY の値を取得する必要があります。 この関数は、 IShellFolder 名前空間拡張機能の実装者によって使用されます。

指定された名前空間拡張機能は、次の 3 つの方法のいずれかでこの API の使用をサポートする必要があります。

1. 指定された名前空間拡張機能が IShellFolder::GetUIObjectOf(..., IID_IQueryAssociations, ...) を実装してアイテムの IQueryAssociations インターフェイスの取得をサポートしている場合、AssocGetDetailsOfPropKey は指定されたファイル関連付け API を使用してプロパティ キーの値を取得します。
2. 指定された名前空間拡張機能が IShellFolder::GetAttributesOf からアイテムのSFGAO_FILESYSTEMを返し、そのアイテムの解析名を指定した場合、AssocGetDetailsOfPropKey は標準のファイル システムの関連付けを使用してプロパティ キーの値を取得します。
3. 指定された名前空間拡張機能が IShellFolder::GetAttributesOf からアイテムのSFGAO_BROWSABLE SFGAO_FOLDERを返す | 場合、AssocGetDetailsOfPropKey はフォルダーのファイル関連付け (ASSOCCLASS_FOLDER) を使用してプロパティ キーの値を取得します。

実装されている ShellFolder に、ファイル関連付けメカニズムを通じて拡張可能な項目が含まれている場合は、この関数を使用して、特定のファイル関連付けに対して宣言されている PropertyKeys を取得できます。 たとえば、特定のシェル フォルダーによって詳細ウィンドウが表示され、そのウィンドウに表示されるプロパティがサード パーティのファイル名拡張子によって管理されるようにする場合は、この関数を使用して PKEY_PropList_PreviewDetailsを返すことができます。 このキーには、そのファイル名拡張子のレジストリで宣言されている値があり、セミコロンで区切られたプロパティの一覧があります。 レジストリに定義されているファイル名拡張子のプロパティの一覧があります。 この一覧には以下が含まれますが、これらに限定されません。

• PKEY_PropList_PreviewDetails
• PKEY_PropList_PreviewTitle
• PKEY_PropList_FullDetails
• PKEY_PropList_TileInfo
• PKEY_PropList_ExtendedTileInfo
• PKEY_PropList_InfoTip
• PKEY_PropList_QuickTip
• PKEY_PropList_FileOperationPrompt
• PKEY_PropList_ConflictPrompt
• PKEY_PropList_SetDefaultsFor
• PKEY_PropList_NonPersonal
• PKEY_NewMenuPreferredTypes
• PKEY_NewMenuAllowedTypes

要件

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