ICallFrame::Free-Methode (callobj.h)

  • Artikel

Gibt die Framekopie frei, um ein Speicherleck zu vermeiden.

Wenn eine Kopie eines Aufrufrahmens mit der Copy-Methode erstellt wird, wird der Aufrufrahmen nicht automatisch die kopierten Daten bereinigen. Nachdem eine Kopie des Anrufrahmens zurückgegeben wurde, ist der Benutzer daher dafür verantwortlich, die Free-Methode aufzurufen, um die Framekopie freizugeben und einen Speicherverlust zu vermeiden.

Syntax

HRESULT Free(
  [in] ICallFrame       *pframeArgsDest,
  [in] ICallFrameWalker *pWalkerDestFree,
  [in] ICallFrameWalker *pWalkerCopy,
  [in] DWORD            freeFlags,
  [in] ICallFrameWalker *pWalkerFree,
  [in] DWORD            nullFlags
);

Parameter

[in] pframeArgsDest

Ein Zeiger auf eine Instanz der ICallFrame-Schnittstelle . Stellt den Stapelzeiger des Aufrufrahmens dar, in den die Outparameter kopiert werden sollen, bevor die Framekopie freigestellt wird. Der Zielrahmen ist in der Regel der übergeordnete Frame, aus dem der Frame ursprünglich kopiert wurde. Dieser Parameter ist optional.

Wenn Sie einen Frame freizugeben und einen pframeArgsDest-Parameter angeben, der sich im gleichen Speicherplatz wie der des Empfängerrahmens befindet, wird dann nur der pWalkerCopy-Parameter auf jedem Schnittstellenzeiger aufgerufen.

[in] pWalkerDestFree

Ein Zeiger auf eine Instanz der ICallFrameWalker-Schnittstelle . Wenn in pframeArgsDest Parameter vorhanden sind, erfordert die Verteilung, dass diese Werte freigestellt werden. Durch die Bereitstellung des pWalkerDestFree-Objekts werden Schnittstellenzeiger freigestellt. Wenn pframeArgsDestNULL ist, muss dieser Parameter auch NULL sein, und die Schnittstellenzeiger sollten durch Aufrufen der Release-Methode freigegeben werden.

[in] pWalkerCopy

Ein Zeiger auf eine Instanz der ICallFrameWalker-Schnittstelle . Wenn die In- und Out-Parameter in pframeArgsDest freigestellt werden, wird die Verteilung von Parametern durchgeführt. Wenn dieser Parameter nicht angegeben wird, wird der Schnittstellenzeiger an AddRef übergeben. Dieser Parameter ist optional.

[in] freeFlags

Flags aus der CALLFRAME_FREE-Aufzählung .

[in] pWalkerFree

Ein Zeiger auf eine Instanz der ICallFrameWalker-Schnittstelle . Wenn angegeben, wird ein Rückruf für jeden Schnittstellenzeiger vorgenommen, während das Freistellen auftritt. Wenn dieser Parameter nicht angegeben wird, werden die Schnittstellenzeiger durch die Release-Methode freigelassen.

[in] nullFlags

Flags aus der CALLFRAME_NULL Enumeration.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile callobj.h

Siehe auch

ICallFrame