Fungsi NdrConformantStringUnmarshall (rpcndr.h)

Artikel
03/01/2024

Fungsi NdrConformantStringUnmarshall membatalkan nama string yang sesuai dari buffer jaringan ke memori.

Sintaks

unsigned char * NdrConformantStringUnmarshall(
  [in, out] PMIDL_STUB_MESSAGE pStubMsg,
  [out]     unsigned char      **ppMemory,
  [in]      PFORMAT_STRING     pFormat,
  [in]      unsigned char      fMustAlloc
);

Parameter

[in, out] pStubMsg

Penunjuk ke struktur MIDL_STUB_MESSAGE yang mempertahankan status stub RPC saat ini. Struktur ini hanya untuk penggunaan internal dan tidak boleh dimodifikasi.

[out] ppMemory

Alamat ke penunjuk ke untai (karakter) yang sesuai dengan unmarshalled. Jika diatur ke null, atau jika fMustAlloc diatur ke TRUE, stub akan mengalokasikan memori.

[in] pFormat

Arahkan ke deskripsi string format.

[in] fMustAlloc

Bendera yang menentukan apakah stub harus mengalokasikan memori tempat string yang sesuai akan dinamai marshal. Tentukan TRUE jika RPC harus mengalokasikan ppMemory.

Mengembalikan nilai

Mengembalikan null setelah berhasil. Jika terjadi kesalahan, fungsi akan melemparkan salah satu kode pengecualian berikut.

Kesalahan	Deskripsi
RPC_BAD_STUB_DATA atau RPC_X_INVALID_BOUND	Jaringan salah.
RPC_S_OUT_OF_MEMORY	Kehabisan memori.
STATUS_ACCESS_VIOLATION	Terjadi pelanggaran akses.
RPC_S_INTERNAL_ERROR	Terjadi kesalahan dalam RPC.

Persyaratan

Persyaratan	Nilai
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	rpcndr.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Bagikan melalui