Fungsi RpcMgmtSetComTimeout (rpcdce.h)

Fungsi RpcMgmtSetComTimeout menetapkan nilai batas waktu komunikasi pengikatan dalam handel pengikatan.

Sintaks

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

Parameter

Binding

Handel pengikatan server yang nilai waktu habisnya ditetapkan.

Timeout

Nilai batas waktu komunikasi, dari nol hingga 10. Nilai-nilai ini bukan detik; mereka mewakili jumlah waktu relatif pada skala nol hingga 10.

Menampilkan nilai

Nilai Makna
RPC_S_OK
Panggilan berhasil.
RPC_S_INVALID_BINDING
Handel pengikatan tidak valid.
RPC_S_INVALID_TIMEOUT
Nilai waktu habis tidak valid.
RPC_S_WRONG_KIND_OF_BINDING
Ini adalah jenis pengikatan yang salah untuk operasi.
 
Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.
 

Keterangan

Di Windows XP dan Windows 2000, selama mengikat run time RPC menggunakan waktu habis panggilan 15 menit yang lebih singkat, dan waktu habis yang ditetapkan menggunakan fungsi RpcMgmtSetComTimeout . Dalam pertukaran berikutnya ke pengikatan, run time RPC hanya menggunakan waktu habis yang ditetapkan dalam menggunakan fungsi RpcMgmtSetComTimeout . Opsi ini diabaikan untuk urutan protokol ncalrpc dan ncadg_* .

Aplikasi klien memanggil RpcMgmtSetComTimeout untuk mengubah nilai batas waktu komunikasi untuk handel pengikatan server. Bergantung pada urutan protokol untuk handel pengikatan yang ditentukan, nilai waktu habis hanya bertindak sebagai petunjuk ke pustaka run-time RPC. Setiap urutan protokol menafsirkan pengaturan ini secara berbeda; untuk ncacn_ip_tcp, nilai digunakan untuk mengaktifkan tetap hidup untuk semua panggilan. Misalnya, untuk ncacn_ip_tcp, mengatur Batas Waktu ke nol menginstruksikan RPC untuk mengaktifkan tetap hidup jika respons tidak diterima dalam 60 detik (interval 60 detik khusus implementasi dan dapat berubah). Dalam situasi ini, panggilan klien tidak kehabisan waktu selama server yang kami jalankan; namun, jika server gagal atau kehilangan alamat IP-nya, RPC akan gagal dalam panggilan. Petunjuk batas waktu TCP digunakan selama pembentukan koneksi, serta selama pertukaran permintaan/balasan.

Catatan Menggunakan petunjuk waktu habis TCP adalah praktik terbaik untuk mendeteksi server yang gagal.

Di Windows XP, tetap hidup untuk koneksi tertentu dimatikan saat server merespons.

 
Untuk kenyamanan, konstanta disediakan untuk nilai tertentu dalam rentang waktu habis. Untuk daftar nilai yang ditentukan RPC yang dapat digunakan aplikasi untuk argumen waktu habis, lihat Mengikat Konstanta Waktu Habis.

Persyaratan

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

Lihat juga

RpcMgmtInqComTimeout