Bagikan melalui


Fungsi RpcAsyncInitializeHandle (rpcasync.h)

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

Lihat juga

RPC asinkron

RPC_ASYNC_STATE

RpcAsyncAbortCall

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcServerTestCancel