TcQueryInterface

TcQueryInterface 1:

Die Methode fragt die Referenz an einer implementierten Schnittstelle über der ID ab.

TcQueryInterface 2: Rückgabewert

VAR_OUTPUT
    TcQueryInterface : HRESULT;
END_VAR

Name

Typ

Beschreibung

TcQueryInterface

HRESULT

Informiert über Erfolg der Schnittstellenabfrage.
Wenn die verlangte Schnittstelle nicht verfügbar ist, gibt die Methode ADS_E_NOINTERFACE zurück.

TcQueryInterface 3: Eingänge

VAR_INPUT
    iid    : REFERENCE TO IID;
    pipItf : POINTER TO PVOID;
END_VAR

Name

Typ

Beschreibung

iid

REFERENCE TO IID

Schnittstelle ID

pipItf

POINTER TO PVOID

Zeiger auf Schnittstellenzeiger. Wird gesetzt, wenn der verlangte Schnittstellentyp von der entsprechenden Instanz verfügbar ist.

TcQueryInterface 4:

Notwendige Freigabe der Schnittstellenzeiger

Sie müssen alle Referenzen explizit wieder freigeben. Wir empfehlen, 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