Fungsi RpcAsyncInitializeHandle (rpcasync.h)

Artikel
08/25/2023

Klien memanggil fungsi RpcAsyncInitializeHandle untuk menginisialisasi struktur RPC_ASYNC_STATE yang akan digunakan untuk melakukan panggilan asinkron.

Sintaks

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

Parameter

pAsync

Arahkan ke struktur RPC_ASYNC_STATE yang berisi informasi panggilan asinkron.

Size

Ukuran struktur RPC_ASYNC_STATE .

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_ARG	Ukurannya terlalu kecil atau terlalu besar.
RPC_S_INVALID_ASYNC_HANDLE	pAsync menunjuk ke memori yang tidak valid.

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

Keterangan

Klien membuat struktur RPC_ASYNC_STATE baru dan pointer ke struktur tersebut dan memanggil RpcAsyncInitializeHandle dengan pointer sebagai parameter input. Fungsi RpcAsyncInitializeHandle menginisialisasi bidang yang digunakannya untuk mempertahankan status panggilan jarak jauh asinkron. Ketika panggilan ke RpcAsyncInitializeHandle berhasil dikembalikan, klien dapat mengatur jenis pemberitahuan dan bidang apa pun yang terkait dengan jenis pemberitahuan tersebut dalam struktur RPC_ASYNC_STATE . Aplikasi klien menggunakan penunjuk ke struktur ini untuk melakukan panggilan asinkron.

Klien tidak boleh mencoba mengubah anggota Ukuran, Tanda Tangan, Kunci, dan StubInfo dari struktur RPC_ASYNC_STATE ; melakukannya akan membatalkan handel.

Catatan Di Windows 2000, setelah panggilan asinkron selesai, struktur RPC_ASYNC_STATE harus diinisialisasi ulang sebelum digunakan untuk panggilan asinkron lainnya. Di Windows XP dan yang lebih baru, struktur RPC_ASYNC_STATE siap untuk segera digunakan kembali berikutnya ke panggilan asinkron yang telah selesai.

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