PathResolve 関数 (shlobj_core.h)
[PathResolve は、[要件] セクションで指定したオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。
相対パス名または非修飾パス名を完全修飾パス名に変換します。
構文
int PathResolve(
[in, out] PWSTR pszPath,
[in, optional] PZPCWSTR dirs,
UINT fFlags
);
パラメーター
[in, out] pszPath
種類: PWSTR
解決するパスを含む null で終わる Unicode 文字列。 関数が戻るときに、文字列には対応する完全修飾パスが含まれます。 このバッファーは、少なくともMAX_PATH文字の長さにする必要があります。
[in, optional] dirs
種類: PZPCWSTR
pszPath からパスを解決できない場合に最初に検索するディレクトリの null で終わるオプションの配列へのポインター。 この値には NULL を指定できます。
fFlags
型: UINT
関数の動作方法を指定するフラグ。
PRF_VERIFYEXISTS
ファイルの存在が検証された場合は TRUE を 返します。それ以外の場合 は FALSE。
PRF_TRYPROGRAMEXTENSIONS
拡張子が .pif、.com、.bat、.cmd、.lnk、.exe が追加された指定したパスを探します。
PRF_FIRSTDIRDEF
dirs で指定されたディレクトリで最初に検索します。
PRF_DONTFINDLNK
.lnkファイルを無視します。
PRF_REQUIREABSOLUTE
絶対 (完全) パスが必要です。
戻り値
型: int
PRF_VERIFYEXISTSが設定されていない限り、 TRUE を返します。 そのフラグが設定されている場合、ファイルが存在することが確認された場合は TRUE が返され、それ以外の場合は FALSE が 返されます。 また、 GetLastError を呼び出して取得できるERROR_FILE_NOT_FOUNDエラー コードも設定します。
注釈
FALSE 戻り値は、必ずしもファイルが存在しないことを意味するとは限りません。 これは、関数が指定された情報からファイルを見つけることができないことを意味する可能性があります。
PathResolve が pszPath で指定されたパスを解決できない場合は、パラメーターとして pszPath と dirs を使用して PathFindOnPath を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj_core.h (Shlobj.h を含む) |
| Library | Shell32.lib |
| [DLL] | Shell32.dll (バージョン 5.0 以降) |
| API セット | ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入) |