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 字符串指针的地址。 实现此方法的应用程序必须通过调用 CoTaskMemAllocppwszTip 分配内存。 调用应用程序必须调用 CoTaskMemFree ,以在不再需要内存时释放内存。

返回值

类型: HRESULT

如果函数成功,则返回S_OK。 如果没有信息提示文本可用, ppwszTip 设置为 NULL。 否则,返回 COM 定义的错误值。

要求

要求
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (版本 4.71 或更高版本)

另请参阅

IQueryInfo