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.
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 |
|
|
Library |
|
|
DLL |
|
See also