IPS_SupportsSearching

 bool IPS_SupportsSearching (int $InstanzID) 

Parameterliste

Rückgabewert

Unterstützt die Instanz den Suchmodus, wird TRUE zurückgemeldet, andernfalls FALSE.

Beschreibung

Die Funktion prüft, ob das Modul der Instanz mit der ID InstanzID einen Suchmodus unterstützt, der mit IPS_StartSearch gestartet werden kann. Bei einer nicht existierenden Instanz schlägt sie mit "Instance #... does not exist" fehl.

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.

Dieselbe Information enthält der Eintrag InstanceSupportsSearching von IPS_GetInstance.

Beispiel

if (IPS_SupportsSearching(12345)) {
    echo 'Die Instanz unterstützt den Suchmodus';
}