ASM Community

IShellLink::GetPath


Retrieves the path and file name of a shell link object.

HRESULT STDMETHODCALLTYPE GetPath(
LPSTR pszFile,
int cchMaxPath,
WIN32_FIND_DATA *pfd,
DWORD fFlags
);

Parameters
pszFile
Address of a buffer that receives the path and file name of the shell link object.
cchMaxPath
Maximum number of bytes to copy to the buffer pointed to by the pszFile parameter.
pfd
Address of a WIN32_FIND_DATA structure that contains information about the shell link object.
fFlags
Flags that specify the type of path information to retrieve. This parameter can be a combination of the following values: Flag Description
SLGP_SHORTPATH Retrieves the standard short (8.3 format) file name.
SLGP_UNCPRIORITY Retrieves the Universal Naming Convention (UNC) path name of the file.
SLGP_RAWPATH Retrieves the raw path name. A raw path is something that might not exist and may include environment variables that need to be expanded.

Return Values
Returns NOERROR if the operation is successful, and a valid path is retrieved. If the operation is successful, but no path is retrieved, it returns S_FALSE and pszPath will be empty. Otherwise, it returns an OLE-defined error value.

See Also
IShellLink

Requirements
Version 4.00 and later of Shell32.dll

Windows NT/2000: Requires Windows NT 4.0 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in shlobj.h.