Fungsi RpcServerUseProtseqIfExW (rpcdce.h)
Fungsi RpcServerUseProtseqIfEx memberi tahu pustaka run-time RPC untuk menggunakan urutan protokol yang ditentukan yang dikombinasikan dengan titik akhir dalam spesifikasi antarmuka untuk menerima panggilan prosedur jarak jauh.
Sintaks
RPC_STATUS RpcServerUseProtseqIfExW(
RPC_WSTR Protseq,
unsigned int MaxCalls,
RPC_IF_HANDLE IfSpec,
void *SecurityDescriptor,
PRPC_POLICY Policy
);
Parameter
Protseq
Penunjuk ke pengidentifikasi string urutan protokol untuk mendaftar dengan pustaka run-time RPC.
MaxCalls
Panjang antrean backlog untuk urutan protokol ncacn_ip_tcp . Semua urutan protokol lainnya mengabaikan parameter ini. Gunakan RPC_C_PROTSEQ_MAX_REQS_DEFAULT untuk menentukan nilai default. Lihat Keterangan.
IfSpec
Antarmuka yang berisi informasi titik akhir untuk digunakan dalam membuat pengikatan untuk urutan protokol yang ditentukan dalam parameter Protseq .
SecurityDescriptor
Penunjuk ke parameter opsional yang disediakan untuk subsistem keamanan. Hanya digunakan untuk urutan protokol ncacn_np dan ncalrpc . Semua urutan protokol lainnya mengabaikan parameter ini. Menggunakan deskriptor keamanan pada titik akhir untuk membuat server aman tidak disarankan. Parameter ini tidak muncul dalam spesifikasi DCE untuk API ini.
Policy
Arahkan ke struktur RPC_POLICY , yang berisi bendera untuk membatasi alokasi port untuk port dinamis dan yang memungkinkan komputer multihomed untuk secara selektif mengikat kartu antarmuka jaringan.
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
|
Titik akhir untuk urutan protokol ini tidak ditentukan dalam file IDL. |
|
Urutan protokol tidak didukung pada host ini. |
|
Urutan protokol tidak valid. |
|
Format titik akhir tidak valid. |
|
Sistem kehabisan memori. |
|
Deskriptor keamanan tidak valid. |
Keterangan
Parameter dan efek RpcServerUseProtseqIfEx memperluas RpcServerUseProtseqIf. Perbedaannya adalah parameter Policy , yang memungkinkan Anda membatasi alokasi port untuk port dinamis dan memungkinkan komputer multihomed untuk secara selektif mengikat kartu antarmuka jaringan.
Mengatur bidang NICFlags dari struktur RPC_POLICY ke 0 membuat API yang diperluas ini secara fungsional setara dengan RpcServerUseProtseqIf asli, dan server akan mengikat NIC berdasarkan pengaturan dalam registri sistem. Untuk informasi tentang bagaimana pengaturan registri menentukan port Internet dan intranet yang tersedia, lihat Mengonfigurasi Registri untuk Alokasi Port dan Pengikatan Selektif.
Untuk menerima permintaan panggilan prosedur jarak jauh, server harus mendaftarkan setidaknya satu urutan protokol dengan pustaka run-time RPC. Aplikasi server dapat memanggil rutinitas ini beberapa kali untuk mendaftarkan urutan protokol tambahan.
Untuk setiap urutan protokol yang didaftarkan oleh server, pustaka run-time RPC membuat satu atau beberapa titik akhir di mana server menerima permintaan panggilan prosedur jarak jauh. Pustaka run-time RPC membuat titik akhir yang berbeda untuk setiap urutan protokol. Namun, setiap antarmuka dalam proses dapat diakses melalui titik akhir apa pun. Untuk informasi selengkapnya, lihat Menulis Klien atau Server RPC Aman.
Untuk MaxCalls, nilai yang disediakan oleh aplikasi hanyalah petunjuk. Run time RPC atau penyedia Windows Sockets dapat mengambil alih nilai. Misalnya, pada Windows XP atau Windows 2000 Professional, nilainya dibatasi hingga 5. Nilai yang lebih besar dari 5 diabaikan dan 5 digunakan sebagai gantinya. Pada Windows Server 2003 dan Windows 2000 Server, nilainya akan dihormati.
Aplikasi harus berhati-hati untuk melewati nilai yang wajar di MaxCalls. Nilai besar di Server, Server Tingkat Lanjut, atau Server Pusat Data dapat menyebabkan sejumlah besar memori kumpulan non-halaman digunakan. Menggunakan nilai yang terlalu kecil juga tidak menguntungkan, karena dapat mengakibatkan paket TCP SYN dipenuhi oleh TCP RST dari server jika antrean backlog habis. Pengembang aplikasi harus menyeimbangkan jejak memori versus persyaratan skalabilitas saat menentukan nilai yang tepat untuk MaxCalls.
Ketika komputer dikonfigurasi untuk menggunakan pengikatan selektif, pengembalian yang berhasil tidak menjamin bahwa server telah membuat titik akhir untuk semua antarmuka jaringan yang ada di komputer. Run-time RPC mungkin tidak mendengarkan beberapa antarmuka jaringan tergantung pada pengaturan pengikatan selektif. Selain itu, jika antarmuka belum menerima alamat IP menggunakan DHCP, server RPC tidak mendengarkan antarmuka jaringan sampai alamat DHCP ditetapkan untuk itu. Pengembalian yang berhasil menyiratkan bahwa server mendengarkan setidaknya satu antarmuka jaringan; daftar lengkap handel pengikatan di mana panggilan prosedur jarak jauh dapat diterima dapat diperoleh dengan panggilan ke fungsi RpcServerInqBindings.
Untuk mendaftarkan semua urutan protokol dari file IDL, server memanggil RpcServerUseAllProtseqsIfEx. Untuk informasi selengkapnya, lihat Pengikatan Sisi Server. Untuk daftar urutan protokol yang didukung Microsoft RPC, lihat Pengikatan String.
Catatan
Header rpcdce.h mendefinisikan RpcServerUseProtseqIfEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | rpcdce.h (termasuk Rpc.h) |
Pustaka | Rpcrt4.lib |
DLL | Rpcrt4.dll |
Lihat juga
Menulis Klien atau Server RPC Aman