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
パスと既知のフォルダーの一致の精度を指定する次のいずれかの値。
FFFP_EXACTMATCH
指定されたファイル パスの特定の既知のフォルダーのみを取得します。
FFFP_NEARESTPARENTMATCH
特定のファイル パスに完全一致が見つからない場合は、親ツリーを上に移動する親フォルダーのいずれかに一致する最初の既知のフォルダーを取得します。
[out] ppkf
種類: IKnownFolder**
このメソッドから制御が戻るときに、既知のフォルダーを表す IKnownFolder オブジェクトへのポインターのアドレスが格納されます。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |
| [DLL] | Shell32.dll |