IQueryInfo::GetInfoTip-Methode (shlobj_core.h)

  • Artikel

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)

Weitere Informationen

IQueryInfo