Dokumentation
IPS_GetInstance
array IPS_GetInstance (int $InstanzID)
Parameterliste
| InstanzID | Die zu zeigende InstanzID |
Rückgabewert
Folgende Informationen stehen als key => value Paare zur Verfügung:
| Index | Typ | Beschreibung |
|---|---|---|
| InstanceID | integer | InstanzID |
| ConnectionID | integer | ID der verbundenen Instanz |
| InstanceStatus | integer | siehe Tabelle "Status der Instanz" |
| InstanceSupportsSearching | boolean | Unterstützt die Instanz den Suchmodus |
| InstanceIsSearching | boolean | Die Instanz befindet sich gerade im Suchmodus |
| InstanceChanged | integer | Unix Zeitstempel zu dem das letzte mal die Konfiguration übernommen wurde |
| ModuleInfo | array | siehe Tabelle "Modulinformationen" |
Tabelle: Status der Instanz
| Code | Status |
|---|---|
| 101 | Instanz wird erstellt |
| 102 | Instanz ist aktiv |
| 103 | Instanz wird gelöscht |
| 104 | Instanz ist inaktiv |
| 105 | Instanz wurde nicht erstellt |
| >=200 | Instanz ist fehlerhaft |
Tabelle: Modulinformationen
| Index | Typ | Beschreibung |
|---|---|---|
| ModuleID | string | ModulID zur Instanz |
| ModuleName | string | ModulName der Instanz |
| ModuleType | integer | ModulTyp der Instanz (0: Kern, 1: I/O, 2: Splitter, 3: Gerät, 4: Konfigurator, 5: Discovery, 6: Visualisierung) |
Beschreibung
Die Funktion liefert ein Array mit Informationen über die Instanz mit der ID InstanzID. Sollte die Instanz nicht vorhanden sein, wird eine Warnung generiert.
Beispiel
print_r(IPS_GetInstance(19668));
/* liefert z.B.:
Array
(
[InstanceID] => 19668
[InstanceStatus] => 102
[LastChange] => 0
[ModuleInfo] => Array
(
[ModuleID] => {48FCFDC1-11A5-4309-BB0B-A0DB8042A969}
[ModuleName] => FS20
[ModuleType] => 3
)
[ConnectionID] => 29416
)
*/