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 版或更新版本) |