Dokumentation
IPS_GetRemoteObject
int IPS_GetRemoteObject (int $ObjektID)
Parameterliste
| ObjektID | ID des gespiegelten Objekts auf dem lokalen System |
Rückgabewert
ID des Objekts auf dem entfernten System
Beschreibung
Diese Funktion ist nur für den internen Gebrauch vorgesehen und kann sich jederzeit ohne Ankündigung ändern oder entfallen.
Die Funktion liefert zum gespiegelten Objekt ObjektID die ID, welche das Objekt auf dem entfernten System hat. Die zuständige Sync Remote Instanz wird dabei automatisch ermittelt. Die Funktion liest die Zuordnung der Objekt-IDs zwischen dem lokalen System und den gespiegelten entfernten Systemen aus (siehe Sync Remote). Für die lokale Abbildung des Wurzelobjekts des entfernten Systems liefert sie 0.
Ist ObjektID kein gespiegeltes Objekt, schlägt die Funktion mit "Cannot find remote server for #..." fehl.
Die umgekehrte Richtung liefert IPS_FindObjectID.
Beispiel
$remoteID = IPS_GetRemoteObject(12345);
echo "ID auf dem entfernten System: " . $remoteID;
/* liefert z.B.:
ID auf dem entfernten System: 23456
*/