Fungsi MesEncodeDynBufferHandleCreate (midles.h)

Fungsi MesEncodeDynBufferHandleCreate membuat handel pengodean dan kemudian menginisialisasinya untuk gaya buffer serialisasi dinamis.

Sintaks

RPC_STATUS MesEncodeDynBufferHandleCreate(
  char          **pBuffer,
  unsigned long *pEncodedSize,
  handle_t      *pHandle
);

Parameter

pBuffer

Arahkan ke penunjuk ke buffer yang disediakan stub yang berisi pengodean setelah serialisasi selesai.

pEncodedSize

Arahkan ke ukuran pengodean yang telah selesai. Ukuran akan ditulis ke lokasi memori yang diarahkan oleh pEncodedSize dengan operasi pengodean berikutnya.

pHandle

Arahkan ke alamat tempat handel akan ditulis.

Menampilkan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_ARG	Argumen tidak valid.
RPC_S_OUT_OF_MEMORY	Kehabisan memori.

 

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

 

Keterangan

Rutinitas MesEncodeDynBufferHandleCreate digunakan oleh aplikasi untuk mengalokasikan memori dan menginisialisasi handel untuk gaya pengodean buffer dinamis. Saat menggunakan gaya buffer dinamis pengodean, buffer tempat semua data yang dikodekan akan ditempatkan disediakan oleh rintangan. Buffer ini akan dialokasikan oleh mekanisme manajemen memori klien saat ini.

Mungkin ada implikasi performa saat menggunakan gaya ini untuk beberapa pengodean dengan handel yang sama. Buffer tunggal dikembalikan dari pengodean dan data disalin dari buffer perantara. Buffer dilepaskan jika perlu.

Ketika stub dikompilasi menggunakan -protocol all atau -protocol ndr64 dan buffer akan dikodekan menggunakan sintaks transfer NDR64, fungsi MesBufferHandleReset harus dipanggil dengan parameter OpCode-nya diatur ke MES_ENCODE_NDR64.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	midles.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

MesBufferhandleReset

MesHandleFree