Метод 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*
Адрес указателя строки Юникода, который при успешном возврате этого метода получает указатель строки подсказки. Приложения, реализующие этот метод, должны выделять память для ppwszTip путем вызова CoTaskMemAlloc. Вызывающие приложения должны вызывать CoTaskMemFree , чтобы освободить память, когда она больше не нужна.
Возвращаемое значение
Тип: HRESULT
Возвращает S_OK, если функция выполнена успешно. Если текст подсказки недоступен, параметру ppwszTip присваивается значение NULL. В противном случае возвращает значение ошибки, определяемое COM.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlobj_core.h |
| DLL | Shell32.dll (версия 4.71 или более поздняя) |