Fungsi RpcNsBindingSelect (rpcnsi.h)

Artikel
03/01/2024

Fungsi RpcNsBindingSelect mengembalikan handel pengikatan dari daftar handel pengikatan yang kompatibel.

Catatan Fungsi ini tidak didukung pada Windows Vista dan sistem operasi yang lebih baru.

Sintaks

RPC_STATUS RpcNsBindingSelect(
  RPC_BINDING_VECTOR *BindingVec,
  RPC_BINDING_HANDLE *Binding
);

Parameter

BindingVec

Penunjuk ke vektor handel pengikatan server yang kompatibel dengan klien tempat handel pengikatan dipilih. Vektor pengikatan yang dikembalikan tidak lagi mereferensikan handel pengikatan yang dipilih, yang dikembalikan secara terpisah dalam parameter Pengikatan .

Binding

Penunjuk ke handel pengikatan yang dipilih.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_NO_MORE_BINDINGS	Tidak ada lagi pengikatan.

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

Keterangan

Setiap kali klien memanggil fungsi RpcNsBindingSelect , operasi fungsi mengembalikan handel pengikatan lain dari vektor.

Ketika semua handel pengikatan telah dikembalikan dari vektor, fungsi mengembalikan status RPC_S_NO_MORE_BINDINGS dan mengembalikan nilai PengikatanNULL.

Operasi pilih mengalokasikan penyimpanan untuk data yang direferensikan oleh parameter Pengikatan yang dikembalikan. Ketika klien selesai dengan handel pengikatan, klien harus memanggil fungsi RpcBindingFree untuk membatalkan alokasi penyimpanan. Setiap panggilan ke RpcNsBindingSelect memerlukan panggilan yang sesuai ke fungsi RpcBindingFree .

Klien dapat membuat rutinitas pilihan mereka sendiri yang menerapkan kriteria pemilihan khusus aplikasi. Dalam hal ini, RpcStringBindingParse menyediakan akses ke bidang pengikatan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcnsi.h (termasuk Rpc.h)
Pustaka	Rpcns4.lib
DLL	Rpcns4.dll

Lihat juga

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

pilih

Bagikan melalui