FW_SafeRelease
Diese Funktion dekrementiert den Referenzzähler des Objekts, analog zu ITcUnknown.TcRelease(), und setzt den Schnittstellenzeiger zugleich auf null.
Rückgabewert
FW_SafeRelease : HRESULT;
Name | Typ | Beschreibung |
|---|---|---|
FW_SafeRelease | HRESULT | Liefert S_OK, wenn der Funktionsaufruf erfolgreich war. |
Eingänge
VAR_INPUT
pipUnk : POINTER TO ITcUknown;
END_VAR
Name | Typ | Beschreibung |
|---|---|---|
pipUnk | POINTER TO ITcUknown | Spezifiziert die Adresse des Schnittstellenzeigers auf das Objekt. Der Schnittstellenzeiger wird intern auf Nullpointer geprüft. |
Beispiel
Diese Funktion kann beispielweise im Destruktor des Objekts aufgerufen werden, welches einen Interfacepointer auf ein anderes Objekt hält.
METHOD FB_exit : BOOL
VAR_INPUT
bInCopyCode : BOOL; // if TRUE, the exit method is called for exiting an instance that is copied afterwards (online change).
END_VAR
-----------------------------------------------------------------------
IF NOT bInCopyCode THEN // no online change
FW_SafeRelease(ADR(ipItf));
END_IF
Voraussetzungen
TwinCAT Version | Hardware | Einzubindende Bibliotheken |
|---|---|---|
TwinCAT 3.1, Build 4020 | x86, x64, ARM | Tc3_Module |