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

ファイルシステムパスに基づいて既知のフォルダーを表すオブジェクトを取得します。オブジェクトを使用すると、特定のフォルダープロパティのクエリを実行したり、フォルダーの現在のパスを取得したり、フォルダーを別の場所にリダイレクトしたり、 ITEMIDLIST としてフォルダーのパスを取得したりできます。

構文

HRESULT FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

[in] pszPath

種類: LPCWSTR

既知のフォルダーへのパスを含む長MAX_PATHの null で終わる Unicode 文字列へのポインター。

[in] mode

種類: FFFP_MODE

パスと既知のフォルダーの一致の精度を指定する次のいずれかの値。

指定されたファイルパスの特定の既知のフォルダーのみを取得します。

特定のファイルパスに完全一致が見つからない場合は、親ツリーを上に移動する親フォルダーのいずれかに一致する最初の既知のフォルダーを取得します。

[out] ppkf

このメソッドから制御が戻るときに、既知のフォルダーを表す IKnownFolder オブジェクトへのポインターのアドレスが格納されます。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

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