Edit

IQueryInfo::GetInfoTip method (shlobj_core.h)

  • Article

Gets the info tip text for an item.

Syntax

HRESULT GetInfoTip(
        DWORD dwFlags,
  [out] PWSTR *ppwszTip
);

Parameters

dwFlags

Type: DWORD

Flags that direct the handling of the item from which you're retrieving the info tip text. This value is commonly zero (QITIPF_DEFAULT). The following values are recognized.

QITIPF_DEFAULT (0x00000000)

No special handling.

QITIPF_USENAME (0x00000001)

Provide the name of the item in ppwszTip rather than the info tip text.

QITIPF_LINKNOTARGET (0x00000002)

If the item is a shortcut, retrieve the info tip text of the shortcut rather than its target.

QITIPF_LINKUSETARGET (0x00000004)

If the item is a shortcut, retrieve the info tip text of the shortcut's target.

QITIPF_USESLOWTIP (0x00000008)

Search the entire namespace for the information. This value can result in a delayed response time.

QITIPF_SINGLELINE (0x00000010)

Windows Vista and later. Put the info tip on a single line.

[out] ppwszTip

Type: PWSTR*

The address of a Unicode string pointer that, when this method returns successfully, receives the tip string pointer. Applications that implement this method must allocate memory for ppwszTip by calling CoTaskMemAlloc. Calling applications must call CoTaskMemFree to free the memory when it is no longer needed.

Return value

Type: HRESULT

Returns S_OK if the function succeeds. If no info tip text is available, ppwszTip is set to NULL. Otherwise, returns a COM-defined error value.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h
DLL Shell32.dll (version 4.71 or later)

See also

IQueryInfo