Bagikan melalui


struktur RPC_BINDING_HANDLE_TEMPLATE_V1_W (rpcdce.h)

Struktur RPC_BINDING_HANDLE_TEMPLATE_V1 berisi opsi dasar untuk membuat handel pengikatan RPC.

Sintaks

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_W {
  unsigned long  Version;
  unsigned long  Flags;
  unsigned long  ProtocolSequence;
  unsigned short *NetworkAddress;
  unsigned short *StringEndpoint;
  union {
    unsigned short *Reserved;
  } u1;
  UUID           ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_W, *PRPC_BINDING_HANDLE_TEMPLATE_V1_W;

Anggota

Version

Versi struktur ini. Untuk RPC_BINDING_HANDLE_TEMPLATE_V1 ini harus diatur ke 1.

Flags

Bendera nilai yang menjelaskan properti tertentu dari templat RPC.

Nilai Makna
RPC_BHT_OBJECT_UUID_VALID
Anggota ObjectUuid berisi nilai yang valid. Jika bendera ini tidak diatur, maka anggota ObjectUuid tidak berisi UUID yang valid.

ProtocolSequence

String urutan protokol literal yang terkait dengan handel pengikatan ini. Ini bisa menjadi salah satu nilai berikut.

ncalrpc - Menentukan RPC lokal. ncacn_ip_tcp - Menentukan RPC melalui TCP/IP. ncacn_np - Menentukan RPC melalui pipa bernama. ncacn_http - Menentukan RPC melalui HTTP.

NetworkAddress

Penunjuk ke representasi string alamat jaringan yang akan diikat.

StringEndpoint

Penunjuk ke representasi string titik akhir yang akan diikat. Jika titik akhir dinamis digunakan, atur anggota ini ke NULL. Setelah titik akhir diselesaikan, gunakan RpcBindingToStringBinding untuk mendapatkannya.

u1

u1.Reserved

Dicadangkan. Anggota ini harus diatur ke NULL.

ObjectUuid

UUID objek jarak jauh. Semantik untuk UUID ini sama dengan yang untuk pengikatan string. Setelah handel pengikatan dibuat, panggil RpcBindingSetObject untuk mengubah UUID sesuai kebutuhan.

Keterangan

Handel pengikatan cepat sedikit berbeda dari handel pengikatan "klasik" dalam cara penanganannya selama panggilan ke RpcBindingReset. RpcBindingReset adalah panggilan tanpa operasi untuk handel pengikatan cepat statis. Namun, untuk handel pengikatan klasik, RpcBindingReset mengonversi handel pengikatan statis menjadi yang dinamis untuk mempertahankan kompatibilitas mundur.

Tabel berikut menunjukkan perilaku handel pengikatan statis dan dinamis sehubungan dengan RpcBindingReset dan RpcEpResolveBinding.

Jenis Titik Akhir Statis Dinamis
Jenis Handel Pengikatan Cepat Classic Cepat Classic
RpcBindingReset No-op Mengonversi ke dinamis Menghapus titik akhir yang diselesaikan jika ada Menghapus titik akhir yang diselesaikan jika ada
RpcEpResolveBinding No-op No-op Mengatasi titik akhir jika sebelumnya tidak diselesaikan Mengatasi titik akhir jika sebelumnya tidak diselesaikan

Persyaratan

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

Lihat juga

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate