struktur RPC_ENDPOINT_TEMPLATEA (rpcdce.h)

Struktur RPC_ENDPOINT_TEMPLATE menentukan properti titik akhir server grup antarmuka RPC, termasuk urutan dan nama protokol.

Sintaks

typedef struct {
  unsigned long Version;
  RPC_CSTR      ProtSeq;
  RPC_CSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEA, *PRPC_ENDPOINT_TEMPLATEA;

Anggota

Version

Bidang ini dicadangkan dan harus diatur ke 0.

ProtSeq

Penunjuk ke pengidentifikasi string urutan protokol untuk mendaftar dengan pustaka run-time RPC. Hanya ncalrpc, ncacn_ip_tcp, dan ncacn_np yang didukung. Nilai ini tidak boleh NULL.

Endpoint

Penunjuk opsional ke informasi alamat titik akhir untuk digunakan dalam membuat pengikatan untuk urutan protokol yang ditentukan dalam parameter Protseq . Tentukan NULL untuk menggunakan titik akhir dinamis.

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.

Backlog

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 untuk informasi selengkapnya.

Keterangan

Nilai yang disediakan di Backlog 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 Backlog. 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 Backlog.

Catatan

Header rpcdce.h mendefinisikan RPC_ENDPOINT_TEMPLATE 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 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	rpcdce.h (termasuk Rpc.h)

Lihat juga

RpcServerInqBindings