TVM_GETISEARCHSTRING Nachricht

Ruft die inkrementelle Suchzeichenfolge für ein Strukturansichtssteuerelement ab. Das Strukturansichtssteuerelement verwendet die inkrementelle Suchzeichenfolge, um ein Element basierend auf vom Benutzer eingegebenen Zeichen auszuwählen. Sie können diese Nachricht explizit oder mithilfe des makros TreeView_GetISearchString senden.

Parameter

wParam

Muss Null sein.

lParam

Zeiger auf den Puffer, der die inkrementelle Suchzeichenfolge empfängt.

Rückgabewert

Gibt die Anzahl der Zeichen in der inkrementellen Suchzeichenfolge zurück.

Bemerkungen

Sicherheitswarnung: Wenn Sie diese Nachricht falsch verwenden, kann die Sicherheit Ihres Programms beeinträchtigt werden. Sie müssen einen ausreichend großen Puffer zuweisen, um die Zeichenfolge zu halten. Rufen Sie zuerst die Nachricht auf, die NULL in lParam übergibt. Dadurch wird die Anzahl der erforderlichen Zeichen (mit Ausnahme von NULL) zurückgegeben. Rufen Sie dann die Nachricht ein zweites Mal auf, um die Zeichenfolge abzurufen. Sie sollten Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente lesen, bevor Sie fortfahren.

Wenn sich das Strukturansichtssteuerelement nicht im inkrementellen Suchmodus befindet, ist der Rückgabewert 0.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	TVM_GETISEARCHSTRINGW (Unicode) und TVM_GETISEARCHSTRINGA (ANSI)