Methode ITComOnlineChange:PrepareOnlineChange

Diese Methode wird von TwinCAT zur Vorbereitung des Online-Change 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;

Methode ITComOnlineChange:PrepareOnlineChange 1: 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.

Parameter

Name

Typ

Beschreibung

ipOldObj

ITComObject*

Referenz auf das existierende Objekt, welches ausgetauscht wird.

pOldInfo

TmcInstData*

Referenz auf Informationen des existierenden Objektes.

Ü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);