Methode ITComOnlineChange:PrepareOnlineChange

Diese Methode wird zur Vorbereitung des Online-Change aufgerufen.

Die Methode wird von TwinCAT zur Durchführung des OnlineChange aufgerufen. Sie läuft asynchron im Hintergrund, welches bei Zugriffen auf das existierende Objekt beachtet werden muss.
Die Vorbereitung sollte alle Operationen beinhalten, die schon getätigt werden können.

Syntax

virtual       HRESULT      TCOMAPI      PrepareOnlineChange(ITComObject* ipOldObj, TmcInstData* pOldInfo) = 0;

Parameter

ipOldObj: (Typ: ITComObject*) Referenz auf das existierende Objekt, welches ausgetauscht wird.

pOldInfo: (Typ: TmcInstData*) Referenz auf Informationen des existierenden Objektes.

Rückgabewert

Bei Erfolg wird S_OK („0“) oder ein anderer positiver Wert zurückgegeben, vgl. Rückgabewerte. Erweiterte Meldungen beziehen sich dabei insbesondere auf die Spalte HRESULT in ADS Return Codes.

Beschreibung

Über ipOldObj werden die Daten des bisher existierenden Objektes zur Übergabe bereitgestellt, sodass sie übernommen werden können.

Beispielsweise:

ULONG nData = sizeof(m_Parameter);
PVOID pData = &m_Parameter;
ipOldObj->TcGetObjPara(PID_Module1Parameter, nData, pData);