FW_ObjMgr_GetObjectInstance

FW_ObjMgr_GetObjectInstance 1:

Diese Funktion liefert einen Schnittstellenzeiger auf eine mittels Objekt-ID spezifizierte Objektinstanz.

FW_ObjMgr_GetObjectInstance 2: Rückgabewert

FW_ObjMgr_GetObjectInstance : HRESULT;

Name

Typ

Beschreibung

FW_ObjMgr_GetObjectInstance

HRESULT

Liefert S_OK, wenn der Funktionsaufruf erfolgreich war.

FW_ObjMgr_GetObjectInstance 3: Eingänge

VAR_INPUT
    oid    : OTCID;  (*OID of object*)
    iid    : IID;  (*requested interface*)
    pipUnk : POINTER TO ITcUnknown;
END_VAR

Name

Typ

Beschreibung

oid

OTCID

Objekt-ID

iid

IID

Spezifiziert die Schnittstellen-ID, zu welcher ein Schnittstellenzeiger referenziert werden soll.

pipUnk

POINTER TO ITcUnknown

Liefert den Schnittstellenzeiger auf das erstellte Objekt.

FW_ObjMgr_GetObjectInstance 4:

Notwendige Freigabe der Schnittstellenzeiger

Alle Referenzen müssen explizit wieder freigegeben werden. Es wird empfohlen, FW_SafeRelease zu verwenden, um nach der Verwendung eine Freigabe des Schnittstellenzeigers durchzuführen. Häufig wird die Freigabe der Referenzen im Destruktor des Objektes implementiert.

Voraussetzungen

TwinCAT Version

Hardware

Einzubindende Bibliotheken

TwinCAT 3.1, Build 4020

x86, x64, ARM

Tc3_Module