struktur RPC_POLICY (rpcdce.h)

Artikel
03/15/2023

Struktur RPC_POLICY berisi bendera yang menentukan pengikatan pada komputer multihomed, dan alokasi port saat menggunakan protokol ncacn_ip_tcp dan ncadg_ip_udp .

Sintaks

typedef struct _RPC_POLICY {
  unsigned int  Length;
  unsigned long EndpointFlags;
  unsigned long NICFlags;
} RPC_POLICY, *PRPC_POLICY;

Anggota

Length

Ukuran struktur RPC_POLICY , dalam byte. Anggota Length memungkinkan kompatibilitas dengan versi struktur ini di masa mendatang, yang mungkin berisi bidang tambahan. Selalu atur Panjang sama dengan sizeof(RPC_POLICY) saat Anda menginisialisasi struktur RPC_POLICY dalam kode Anda.

EndpointFlags

Set bendera yang menentukan atribut port atau port tempat server menerima panggilan prosedur jarak jauh. Anda dapat menentukan lebih dari satu bendera (dengan menggunakan operator OR bitwise) dari kumpulan nilai untuk urutan protokol tertentu. Tabel berikut mencantumkan nilai yang mungkin untuk anggota EndpointFlags .

Nilai	Makna
0	Menentukan default sistem.
RPC_C_USE_INTERNET_PORT	Mengalokasikan titik akhir dari salah satu port yang ditentukan dalam registri sebagai "Internet Available." Hanya berlaku dengan urutan protokol ncacn_ip_tcp dan ncadg_ip_udp .
RPC_C_USE_INTRANET_PORT	Mengalokasikan titik akhir dari salah satu port yang ditentukan dalam registri sebagai "Intranet Available." Hanya berlaku dengan urutan protokol ncacn_ip_tcp dan ncadg_ip_udp .
RPC_C_MQ_TEMPORARY	Antrean proses-penerimaan server akan dihapus secara otomatis ketika server RPC keluar. Setiap panggilan terutang yang masih dalam antrean akan hilang. Ini adalah default. Hanya berlaku dengan urutan protokol ncadg_mq .
RPC_C_MQ_PERMANENT	Menentukan bahwa antrean proses-penerimaan server tetap ada setelah proses server keluar. Defaultnya adalah antrean dihapus ketika proses server berakhir. Hanya berlaku dengan urutan protokol ncadg_mq.
RPC_C_MQ_CLEAR_ON_OPEN	Jika antrean terima sudah ada karena sebelumnya dibuka sebagai antrean permanen, bersihkan panggilan yang belum terlupakan yang menunggu dalam antrean. Hanya berlaku dengan urutan protokol ncadg_mq saja.
RPC_C_MQ_USE_EXISTING_SECURITY	Jika antrean terima sudah ada, maka jangan ubah pengaturan yang ada untuk autentikasi atau enkripsi. Hanya berlaku dengan urutan protokol ncadg_mq.
RPC_C_MQ_AUTHENTICATE	Antrean proses-penerimaan server hanya menerima panggilan terautentikasi dari klien. Defaultnya adalah bahwa panggilan yang diautentikasi dan tidak diautentikasi diterima. Hanya berlaku dengan urutan protokol ncadg_mq.
RPC_C_MQ_ENCRYPT	Panggilan ke server dienkripsi. Defaultnya adalah bahwa panggilan terenkripsi dan tidak terenkripsi diterima. Hanya berlaku dengan urutan protokol ncadg_mq.
RPC_C_MQ_AUTHN_LEVEL_NONE	Antrean terima server menerima semua panggilan dari klien. Ini adalah tingkat autentikasi default. Hanya berlaku dengan protokol ncadg_mq .
RPC_C_MQ_AUTHN_LEVEL_PKT_INTEGRITY	Mengatur antrean terima server untuk hanya menerima panggilan klien yang memiliki tingkat autentikasi RPC_C_AUTHN_LEVEL_PKT_INTEGRITY atau RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Hanya berlaku dengan urutan protokol ncadg_mq.
RPC_C_MQ_AUTHN_LEVEL_PKT_PRIVACY	Mengatur antrean terima server untuk hanya menerima panggilan klien yang memiliki tingkat autentikasi RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Panggilan dengan tingkat autentikasi yang lebih rendah diabaikan. Hanya berlaku dengan urutan protokol ncadg_mq.

Catatan Jika registri tidak berisi kunci apa pun yang menentukan kebijakan default, maka anggota EndpointFlags tidak akan berpengaruh pada durasi. Jika kunci hilang atau berisi nilai yang tidak valid, maka seluruh konfigurasi untuk protokol tersebut ( ncacn_ip_tcp, ncadg_ip_udp , atau ncadg_mq) ditandai sebagai tidak valid dan semua panggilan ke fungsi RpcServerUseProtseq* melalui protokol tersebut akan gagal.

NICFlags

Kebijakan untuk mengikat Kartu Antarmuka Jaringan (NIC). Tabel berikut mencantumkan nilai yang mungkin untuk anggota NICFlags .

Nilai	Makna
0	Mengikat ke NIC berdasarkan pengaturan registri. Selalu gunakan nilai ini saat Anda menggunakan struktur RPC_POLICY untuk menentukan properti antrean pesan.
RPC_C_BIND_TO_ALL_NICS	Mengambil alih pengaturan registri dan mengikat semua NIC. Jika kunci Ikatan hilang dari registri, maka anggota NICFlags tidak akan berpengaruh pada durasi. Jika kunci berisi nilai yang tidak valid, maka seluruh konfigurasi ditandai sebagai tidak valid dan semua panggilan ke RpcServerUseProtseq* akan gagal.

Keterangan

Anda dapat menggunakan struktur RPC_Policy untuk menetapkan kebijakan untuk panggilan prosedur jarak jauh pada durasi. Kebijakan ini meliputi:

Antrean pesan: Memungkinkan server menentukan properti antrean pesan, seperti keamanan, kualitas pengiriman, dan masa pakai antrean proses server. Kebijakan ini hanya efektif untuk panggilan jarak jauh melalui transportasi antrean pesan (ncadg_mq).
Alokasi port untuk port dinamis: Menentukan apakah titik akhir yang didaftarkan oleh aplikasi ini harus masuk ke set port yang tersedia di Internet atau intranet.
Pengikatan selektif: Memungkinkan komputer multihomed untuk mengikat secara selektif ke NIC.

Catatan Alokasi port dan kebijakan pengikatan selektif hanya efektif untuk panggilan jarak jauh melalui koneksi TCP ( ncacn_ip_tcp) dan UDP ( ncadg_ip_udp). Untuk informasi selengkapnya, lihat Mengonfigurasi Registri untuk Alokasi Port dan Pengikatan Selektif.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	rpcdce.h (termasuk Rpc.h)