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 を呼び出します。

要件

こちらもご覧ください

PathFindOnPath