LVM_GETISEARCHSTRING訊息

擷取清單檢視控制項的累加搜尋字串。 您可以明確傳送此訊息，或使用 ListView_GetISearchString 宏。

參數

wParam

必須為零。

lParam

接收累加搜尋字串之緩衝區的指標。 若要只擷取字串的長度，請將 lParam 設定為 Null。

傳回值

傳回累加搜尋字串中的字元數，不包括終止的 Null 字元，如果清單檢視控制項不在累加搜尋模式中，則傳回零。

備註

安全性警告： 使用此訊息不正確可能會危害程式的安全性。 此訊息不會提供一種方式讓您知道緩衝區的大小。 如果您使用此訊息，請先呼叫在lParam中傳遞Null的訊息，這會傳回字元數，但不包括必要的Null。 然後再次呼叫訊息以擷取字串。 您應該先檢閱 安全性考慮：Microsoft Windows 控制項 ，再繼續進行。

累加搜尋字串是在清單檢視具有輸入焦點時，使用者輸入的字元序列。 每次使用者輸入字元時，系統會將字元附加至搜尋字串，然後搜尋相符的專案。 如果系統找到相符專案，它會選取專案，並視需要將它捲動到檢視中。

逾時期間會與使用者輸入的每個字元相關聯。 如果使用者輸入另一個字元之前經過逾時期間，就會重設累加搜尋字串。

請確定緩衝區夠大，足以保存字串和終止的 Null 字元。 如果太小，將會導致立即不正確分頁錯誤。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Commctrl.h
Unicode 與 ANSI 名稱	LVM_GETISEARCHSTRINGW (Unicode ) 和 anSI LVM_GETISEARCHSTRINGA (ANSI)