IQueryInfo::GetInfoTip-Methode (shlobj_core.h)
Ruft den Infotipptext für ein Element ab.
Syntax
HRESULT GetInfoTip(
DWORD dwFlags,
[out] PWSTR *ppwszTip
);
Parameter
dwFlags
Art: DWORD
Flags, die die Behandlung des Elements leiten, aus dem Sie den Infoinfotext abrufen. Dieser Wert ist in der Regel null (QITIPF_DEFAULT). Die folgenden Werte werden erkannt.
QITIPF_DEFAULT (0x00000000)
Keine spezielle Handhabung.
QITIPF_USENAME (0x00000001)
Geben Sie den Namen des Elements in ppwszTip anstelle des Infotipptexts an.
QITIPF_LINKNOTARGET (0x00000002)
Wenn es sich bei dem Element um eine Verknüpfung handelt, rufen Sie den Infotipptext der Verknüpfung anstelle des Ziels ab.
QITIPF_LINKUSETARGET (0x00000004)
Wenn es sich bei dem Element um eine Verknüpfung handelt, rufen Sie den Infotipptext des Ziels der Verknüpfung ab.
QITIPF_USESLOWTIP (0x00000008)
Durchsuchen Sie den gesamten Namespace nach den Informationen. Dieser Wert kann zu einer verzögerten Antwortzeit führen.
QITIPF_SINGLELINE (0x00000010)
Windows Vista und höher. Platzieren Sie den Infotipp in einer einzigen Zeile.
[out] ppwszTip
Typ: PWSTR*
Die Adresse eines Unicode-Zeichenfolgenzeigers, der den Tippzeichenfolgenzeiger empfängt, wenn diese Methode erfolgreich zurückgibt. Anwendungen, die diese Methode implementieren, müssen Arbeitsspeicher für ppwszTip zuordnen, indem Sie CoTaskMemAlloc aufrufen. Beim Aufrufen von Anwendungen muss CoTaskMemFree aufgerufen werden, um den Arbeitsspeicher freizugeben, wenn er nicht mehr benötigt wird.
Rückgabewert
Typ: HRESULT
Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Wenn kein Infotipptext verfügbar ist, wird ppwszTip auf NULL festgelegt. Andernfalls wird ein COM-definierter Fehlerwert zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h |
| DLL | Shell32.dll (Version 4.71 oder höher) |