Methode ITcCyclicCaller:RemoveModule

Eine Modulinstanz vom Aufruf durch einen zyklischen Aufrufer abmelden.

Syntax

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

Methode ITcCyclicCaller:RemoveModule 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

pEntry

STcCyclicEntry

verweist auf den Listeneintrag, der aus der internen Liste des zyklischen Aufrufers zu entfernen ist.

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

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;