ICallFrame::Metode gratis (callobj.h)

Artikel
03/14/2023

Membebaskan salinan bingkai untuk menghindari kebocoran memori.

Ketika salinan bingkai panggilan dibuat dengan metode Salin , bingkai panggilan tidak membersihkan data yang disalin secara otomatis. Oleh karena itu, setelah salinan bingkai panggilan dikembalikan, pengguna bertanggung jawab untuk memanggil metode Gratis untuk membebaskan salinan bingkai dan menghindari kebocoran memori.

Sintaks

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

Parameter

[in] pframeArgsDest

Penunjuk ke instans antarmuka ICallFrame . Mewakili penunjuk tumpukan bingkai panggilan tempat parameter keluar harus disalin sebelum salinan bingkai dikosongkan. Bingkai tujuan biasanya merupakan bingkai induk tempat bingkai awalnya disalin. Parameter ini bersifat opsional.

Saat membebaskan bingkai dan menentukan parameter pframeArgsDest yang berada di ruang memori yang sama dengan bingkai penerima, maka hanya parameter pWalkerCopy yang dipanggil pada setiap penunjuk antarmuka.

[in] pWalkerDestFree

Penunjuk ke instans antarmuka ICallFrameWalker . Jika ada parameter masuk dan keluar di pframeArgsDest, maka propagasi mengharuskan nilai-nilai tersebut dikosongkan. Dengan menyediakan objek pWalkerDestFree , penunjuk antarmuka akan dikosongkan. Jika pframeArgsDestadalah NULL, maka parameter ini juga harus NULL dan penunjuk antarmuka harus dirilis dengan memanggil metode Rilis .

[in] pWalkerCopy

Penunjuk ke instans antarmuka ICallFrameWalker . Ketika parameter masuk dan keluar di pframeArgsDest dikosongkan , maka penyebaran parameter keluar dilakukan. Jika parameter ini tidak ditentukan, maka penunjuk antarmuka akan diteruskan ke AddRef. Parameter ini bersifat opsional.

[in] freeFlags

Bendera dari enumerasi CALLFRAME_FREE .

[in] pWalkerFree

Penunjuk ke instans antarmuka ICallFrameWalker . Ketika ditentukan, panggilan balik dilakukan untuk setiap penunjuk antarmuka yang ditemui saat pembekuan terjadi. Jika parameter ini tidak ditentukan, maka penunjuk antarmuka dibebaskan oleh metode Rilis .

[in] nullFlags

Bendera dari enumerasi CALLFRAME_NULL .

Mengembalikan nilai

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	callobj.h

Lihat juga

ICallFrame