System.Win.ComObj.CreateRemoteComObject
Delphi
function CreateRemoteComObject(const MachineName: WideString;
const ClassID: TGUID): IUnknown;
C++
extern DELPHI_PACKAGE System::_di_IInterface __fastcall CreateRemoteComObject(const System::WideString MachineName, const GUID &ClassID);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.Win.ComObj.pas System.Win.ComObj.hpp |
System.Win.ComObj | System.Win.ComObj |
Beschreibung
Erzeugt ein COM-Objekt auf einem anderen Rechner und gibt eine IUnknown-Schnittstelle für das Objekt zurück.
Mit CreateRemoteComObject können Sie ein Objekt auf einem Remote-Server erzeugen. CreateRemoteComObject erzeugt ein einzelnes, nicht initialisiertes Objekt der Klasse, deren CLSID im Parameter ClassID übergeben wird. Der Parameter MachineName gibt den Rechner an, dessen Typbibliothek die angegebene ClassID enthält.
Der Parameter MachineName ist normalerweise der UNC-Name des Rechners. Dieser Name kann im Modul Netzwerk der Windows-Systemsteuerung unter Computername nachgeschlagen werden. In einigen COM-Konfigurationen gibt MachineName allerdings die IP-Adresse oder den Host-Namen des Remote-Systems an.
CreateRemoteComObject gibt eine Referenz auf die IUnknown-Schnittstelle für das Objekt zurück. Über diese Schnittstelle können Sie Informationen über weitere vom Objekt unterstützte Schnittstellen abfragen.
Tip: Wenn die von CreateRemoteComObject zurückgegebene Schnittstelle einer Varianten zugewiesen wird, können Sie die Schnittstelle freigeben, indem Sie die Konstante Unassigned dieser Varianten zuweisen.