ICallFrame::Metode unmarshal (callobj.h)

Membatalkan nama paket data yang berisi parameter panggilan [out] yang sebelumnya dinamai ke dalam rekaman aktivasi yang sudah ada ini.

Sintaks

HRESULT Unmarshal(
  [in]  PVOID                    pBuffer,
  [in]  ULONG                    cbBuffer,
  [in]  RPCOLEDATAREP            dataRep,
  [in]  CALLFRAME_MARSHALCONTEXT *pcontext,
  [out] ULONG                    *pcbUnmarshalled
);

Parameter

[in] pBuffer

Penunjuk ke buffer yang berisi nilai marshaled [out].

[in] cbBuffer

Ukuran buffer, dalam byte.

[in] dataRep

Representasi data NDR yang datanya dinamai marshal. Untuk informasi selengkapnya, lihat IRpcChannelBuffer::GetBuffer.

[in] pcontext

Penunjuk ke struktur CALLFRAME_MARSHALCONTEXT yang berisi informasi konteks tentang bagaimana unmarshalling dilakukan.

[out] pcbUnmarshalled

Menerima jumlah byte yang berhasil dibatalkan napasnya. Parameter ini dikembalikan bahkan dalam situasi kesalahan. Parameter ini bersifat opsional.

Menampilkan nilai

Metode ini dapat mengembalikan nilai berikut.

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

Keterangan

Saat membatalkan nama, versi [in] parameter [in, out] dibebaskan dan penunjuk antarmuka dirilis dan diganti dengan versi [out] mereka. Semua parameter [in, out] dan [out] akan selalu diatur ke nilai [in] , [in, out] yang masuk akal, [out] berhasil dibatalkan namanya dari data yang dikembalikan, atau nilai yang secara eksplisit diinisialisasi ke NULL. Pada pengembalian kegagalan, pemanggil biasanya ingin memanggil ICallFrame::Free untuk membersihkan nilai yang bukan NULL.

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