Methode ITcCyclicCaller:RemoveModule

Eine Modulinstanz vom Aufruf durch einen zyklischen Aufrufer abmelden.

Syntax

					virtual HRESULT TCOMAPI
RemoveModule(STcCyclicEntry* pEntry)=0;

Parameter

pEntry: (Typ: STcCyclicEntry) verweist auf den Listeneintrag, der aus der internen Liste des zyklischen Aufrufers zu entfernen ist.

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.

Wenn der Eintrag nicht in der internen Liste ist, gibt die Methode E_FAIL zurück.

Beschreibung

Vergleichbar mit der Methode AddModule() wird der Smart Pointer für den zyklischen Aufrufer als Listeneintrag verwendet, wenn die Modulinstanz aus dem zyklischen Aufrufer entfernt werden soll.

Deklaration und Verwendung des Smart Pointers:

ITcCyclicCallerInfoPtr m_spCyclicCaller;

        if (
m_spCyclicCaller ) {
m_spCyclicCaller->RemoveModule(m_spCyclicCaller);
}
m_spCyclicCaller = NULL;