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*

當這個方法成功傳回時，Unicode 字串指標的位址會接收提示字串指標。 實作此方法的應用程式必須呼叫 CoTaskMemAlloc，為 ppwszTip 配置記憶體。 呼叫應用程式必須呼叫 CoTaskMemFree ，才能在不再需要記憶體時釋放記憶體。

傳回值

類型： HRESULT

如果函式成功，則傳回S_OK。 如果沒有可用的資訊提示文字， ppwszTip 會設定為 NULL。 否則，傳回 COM 定義的錯誤值。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h
Dll Shell32.dll (4.71 版或更新版本)

另請參閱

IQueryInfo