IShellLinkW::GetPath 方法 (shobjidl_core.h)
获取 Shell 链接对象的目标的路径和文件名。
语法
HRESULT GetPath(
[out] LPWSTR pszFile,
[in] int cch,
[in, out] WIN32_FIND_DATAW *pfd,
[in] DWORD fFlags
);
参数
[out] pszFile
类型: LPTSTR
接收 Shell 链接对象目标的路径和文件名的缓冲区的地址。
[in] cch
类型: int
pszFile 参数指向的缓冲区的大小(以字符为单位),包括终止 null 字符。 可返回的最大路径大小为MAX_PATH。 此参数通常是通过调用 arraySIZE (pszFile) 设置的。 ARRAYSIZE 宏在 Winnt.h 中定义。
[in, out] pfd
类型: WIN32_FIND_DATA*
指向 WIN32_FIND_DATA 结构的指针,该结构接收有关 Shell 链接对象的目标的信息。 如果此参数为 NULL,则不返回任何其他信息。
[in] fFlags
类型:DWORD
指定要检索的路径信息类型的标志。 此参数可以是以下值的组合。
SLGP_SHORTPATH
检索文件名) 标准短 (8.3 格式。
SLGP_UNCPRIORITY
支持;请勿使用。
SLGP_RAWPATH
检索原始路径名称。 原始路径可能不存在,可能包含需要扩展的环境变量。
SLGP_RELATIVEPRIORITY
Windows Vista 及更高版本。 如果可能,检索快捷方式的目标相对于先前调用 IShellLink::SetRelativePath 设置的路径。
返回值
类型: HRESULT
如果操作成功并检索到有效路径,则返回 S_OK 。 如果操作成功但未检索到路径,则返回 S_FALSE 且 pszFile 将为空。 否则,它将返回标准 HRESULT 错误值之一。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h |
DLL | Shell32.dll (4.0 或更高版本) |