Fungsi CoGetInterfaceAndReleaseStream (combaseapi.h)

Membatalkan nama buffer yang berisi penunjuk antarmuka dan melepaskan aliran ketika penunjuk antarmuka telah dinamai dari utas lain ke utas panggilan.

Sintaks

HRESULT CoGetInterfaceAndReleaseStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iid,
  [out] LPVOID   *ppv
);

Parameter

[in] pStm

Penunjuk ke antarmuka IStream pada aliran untuk tidak disembunyikan.

[in] iid

Referensi ke pengidentifikasi antarmuka yang diminta dari objek yang belum dipesan.

[out] ppv

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppv berisi penunjuk antarmuka yang diminta ke antarmuka yang tidak disembunyikan.

Menampilkan nilai

Fungsi ini dapat mengembalikan nilai pengembalian standar S_OK dan E_INVALIDARG, serta salah satu nilai yang dikembalikan oleh CoUnmarshalInterface.

Keterangan

Penting  

Catatan Keamanan: Memanggil metode ini dengan data yang tidak tepercaya adalah risiko keamanan. Panggil metode ini hanya dengan data tepercaya.

 

Fungsi CoGetInterfaceAndReleaseStream melakukan tugas-tugas berikut:

• Memanggil CoUnmarshalInterface untuk membatalkan nama penunjuk antarmuka yang sebelumnya diteruskan dalam panggilan ke CoMarshalInterThreadInterfaceInStream.
• Merilis penunjuk aliran. Bahkan jika unmarshaling gagal, aliran masih dirilis karena tidak ada cara yang efektif untuk pulih dari kegagalan semacam ini.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

CoMarshalInterThreadInterfaceInStream

CoUnmarshalInterface