IPS_StopSearch

 bool IPS_StopSearch (int $InstanzID) 

Parameterliste

Rückgabewert

Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Die Funktion beendet den Suchmodus der Instanz mit der ID InstanzID, der mit IPS_StartSearch gestartet wurde. Befindet sich die Instanz nicht im Suchmodus, passiert nichts.

Einige Geräte-Module unterstützen einen Suchmodus, z.B. die Instanzen für FS20, HMS, EnOcean oder HomeMatic. Im Suchmodus meldet die Instanz jedes empfangene Gerät mit seiner Adresse, zusammen mit einer bereits vorhandenen Instanz für diese Adresse. Die Verwaltungskonsole zeigt diese Ergebnisse im Suchdialog an, sodass ein Gerät durch Auslösen am Gerät gefunden und der Instanz zugeordnet werden kann. Der Suchmodus endet automatisch nach 5 Minuten.

Start und Ende der Suche werden über die Nachrichten IM_SEARCHSTART und IM_SEARCHSTOP gemeldet.

Unterstützt das Modul keinen Suchmodus, schlägt die Funktion mit "This module does not support searching" fehl, bei einer nicht existierenden Instanz mit "Instance #... does not exist".

Beispiel

if (IPS_IsSearching(12345)) {
    IPS_StopSearch(12345);
}