Bagikan melalui

struktur RPC_BINDING_HANDLE_TEMPLATE_V1_A (rpcdce.h)

  • Artikel

Struktur RPC_BINDING_HANDLE_TEMPLATE_V1 berisi opsi dasar untuk membuat handel pengikatan RPC.

Sintaks

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_A {
  unsigned long Version;
  unsigned long Flags;
  unsigned long ProtocolSequence;
  unsigned char *NetworkAddress;
  unsigned char *StringEndpoint;
  union {
    unsigned char *Reserved;
  } u1;
  UUID          ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_A, *PRPC_BINDING_HANDLE_TEMPLATE_V1_A;

Anggota

Version

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

Flags

Benderai 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

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

  • RPC_PROTSEQ_LRPC - Menentukan RPC lokal.
  • RPC_PROTSEQ_TCP - Menentukan RPC melalui TCP/IP.
  • RPC_PROTSEQ_NMP - Menentukan RPC melalui pipa bernama.
  • RPC_PROTSEQ_HTTP - Menentukan RPC melalui HTTP.

NetworkAddress

Arahkan 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 no-op 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
Tipe 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