Export (0) Print
Expand All
Expand Minimize

PathResolve function

[PathResolve is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Converts a relative or unqualified path name to a fully qualified path name.

Syntax


int PathResolve(
  _Inout_   PWSTR pszPath,
  _In_opt_  PZPCWSTR dirs,
  UINT fFlags
);

Parameters

pszPath [in, out]

Type: PWSTR

A null-terminated Unicode string that contains the path to resolve. When the function returns, the string contains the corresponding fully qualified path. This buffer should be at least MAX_PATH characters long.

dirs [in, optional]

Type: PZPCWSTR

A pointer to an optional null-terminated array of directories to be searched first in the case that the path cannot be resolved from pszPath. This value can be NULL.

fFlags

Type: UINT

Flags that specify how the function operates.

PRF_VERIFYEXISTS

Return TRUE if the file's existence is verified; otherwise FALSE.

PRF_TRYPROGRAMEXTENSIONS

Look for the specified path with the following extensions appended: .pif, .com, .bat, .cmd, .lnk, and .exe.

PRF_FIRSTDIRDEF

Look first in the directory or directories specified by dirs.

PRF_DONTFINDLNK

Ignore .lnk files.

PRF_REQUIREABSOLUTE

Require an absolute (full) path.

Return value

Type: int

Returns TRUE, unless PRF_VERIFYEXISTS is set. If that flag is set, the function returns TRUE if the file is verified to exist and FALSE otherwise. It also sets an ERROR_FILE_NOT_FOUND error code that you can retrieve by calling GetLastError.

Remarks

A FALSE return value does not necessarily mean that the file does not exist. It might mean that the function is simply unable to find the file from the supplied information.

If PathResolve cannot resolve the path specified in pszPath, it calls PathFindOnPath using pszPath and dirs as the parameters.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP with SP2

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

See also

PathFindOnPath

 

 

Community Additions

ADD
Show:
© 2014 Microsoft