IQueryInfo::GetInfoTip 方法 (shlobj_core.h)
获取项的信息提示文本。
语法
HRESULT GetInfoTip(
DWORD dwFlags,
[out] PWSTR *ppwszTip
);
参数
dwFlags
类型:DWORD
指示处理要从中检索信息提示文本的项的标志。 此值通常为零 (QITIPF_DEFAULT) 。 可识别以下值。
QITIPF_DEFAULT (0x00000000)
无特殊处理。
QITIPF_USENAME (0x00000001)
在 ppwszTip 中提供项目的名称,而不是信息提示文本。
QITIPF_LINKNOTARGET (0x00000002)
如果项是快捷方式,请检索快捷方式的信息提示文本,而不是其目标。
QITIPF_LINKUSETARGET (0x00000004)
如果项是快捷方式,请检索快捷方式目标的信息提示文本。
QITIPF_USESLOWTIP (0x00000008)
在整个命名空间中搜索信息。 此值可能会导致响应时间延迟。
QITIPF_SINGLELINE (0x00000010)
Windows Vista 及更高版本。 将信息提示放在一行上。
[out] ppwszTip
类型: PWSTR*
当此方法成功返回时接收 tip 字符串指针的 Unicode 字符串指针的地址。 实现此方法的应用程序必须通过调用 CoTaskMemAlloc 为 ppwszTip 分配内存。 调用应用程序必须调用 CoTaskMemFree ,以在不再需要内存时释放内存。
返回值
类型: HRESULT
如果函数成功,则返回S_OK。 如果没有信息提示文本可用, ppwszTip 设置为 NULL。 否则,返回 COM 定义的错误值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shlobj_core.h |
DLL | Shell32.dll (版本 4.71 或更高版本) |