Bagikan melalui

Fungsi CoGetInterfaceAndReleaseStream (combaseapi.h)

  • Artikel

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