Dokumentation
IPS_GetMediaID
int IPS_GetMediaID (string $MedienName)
Parameterliste
MedienName | Zu suchender Medienname |
Rückgabewert
ID des gefundenen Medienobjekts, sonst 0
Beschreibung
Die Funktion versucht, die ID des Medienobjekts mit dem Namen MedienName zu ermitteln. Es wird die ID des ersten gefundenen Medienobjekts verwendet, dessen Name mit MedienName übereinstimmt. Falls ein solches Medienobjekt gefunden wurde, wird dessen ID zurückgemeldet, andernfalls 0 (Null).
Eine sicherere Methode, die ID zu bestimmen, bietet die Funktion IPS_GetMediaIDByName.
Vorsicht: Da Namen in IP-Symcon beliebig vergeben werden können, und damit nicht eindeutig sind, kann die Funktion eine falsche ID zurückmelden.
Beispiel
$MediaID = IPS_GetMediaID("Regenmenge");
if ($MediaID == 0)
echo "Medienobjekt nicht gefunden!";
else
echo "Die Medienobjekt-ID lautet: ". $MediaID;