Fungsi RpcNsBindingLookupBeginA (rpcnsi.h)

Artikel
08/25/2023

Fungsi RpcNsBindingLookupBegin membuat konteks pencarian untuk antarmuka dan objek.

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

Sintaks

RPC_STATUS RpcNsBindingLookupBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  unsigned long BindingMaxCount,
  RPC_NS_HANDLE *LookupContext
);

Parameter

EntryNameSyntax

Sintaks parameter EntryName .

Untuk menggunakan sintaks yang ditentukan dalam entri nilai registri HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, berikan nilai RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Penunjuk ke nama entri tempat pencarian pengikatan yang kompatibel dimulai.

Untuk menggunakan nama entri yang ditentukan dalam entri nilai registri HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, berikan penunjuk null atau string kosong. Dalam hal ini, parameter EntryNameSyntax diabaikan dan pustaka run-time menggunakan sintaks default.

IfSpec

Struktur yang dihasilkan stub menunjukkan antarmuka untuk mencari. Jika spesifikasi antarmuka belum diekspor atau tidak menjadi perhatian pemanggil, tentukan nilai null untuk parameter ini. Dalam hal ini, pengikatan yang dikembalikan hanya dijamin memiliki urutan protokol yang kompatibel dan didukung dan berisi UUID objek yang ditentukan. Antarmuka yang diinginkan mungkin tidak didukung oleh server yang dihubungi.

ObjUuid

Penunjuk ke UUID objek opsional.

Untuk UUID nonzero, handel pengikatan yang kompatibel dikembalikan dari entri hanya jika server telah mengekspor UUID objek yang ditentukan.

Untuk nilai pointer null atau UUID nihil untuk parameter ini, handel pengikatan yang dikembalikan berisi salah satu UUID objek yang diekspor oleh server yang kompatibel. Jika server tidak mengekspor UUID objek apa pun, handel pengikatan yang kompatibel yang dikembalikan berisi UUID objek nihil.

BindingMaxCount

Jumlah maksimum pengikatan yang dikembalikan dalam parameter BindingVec dari fungsi RpcNsBindingLookupNext .

Tentukan nilai nol untuk menggunakan jumlah default RPC_C_BINDING_MAX_COUNT_DEFAULT.

LookupContext

Mengembalikan penunjuk ke handel layanan nama untuk digunakan dengan fungsi RpcNsBindingLookupNext dan RpcNsBindingLookupDone .

Mengembalikan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_NAME_SYNTAX	Sintaks nama tidak valid.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Sintaks nama tidak didukung.
RPC_S_INCOMPLETE_NAME	Nama tidak lengkap.
RPC_S_ENTRY_NOT_FOUND	Entri layanan-nama tidak ditemukan.
RPC_S_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.
RPC_S_INVALID_OBJECT	Objek tidak valid.

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

Keterangan

Fungsi RpcNsBindingLookupBegin membuat konteks pencarian untuk menemukan handel pengikatan yang kompatibel dengan klien ke server yang menawarkan antarmuka dan objek yang ditentukan.

Sebelum memanggil RpcNsBindingLookupNext, aplikasi klien harus terlebih dahulu memanggil RpcNsBindingLookupBegin untuk membuat konteks pencarian. Parameter untuk fungsi ini mengontrol pengoperasian fungsi RpcNsBindingLookupNext .

Efektif dengan Windows 2000, lingkungan RPC menggunakan Direktori Aktif sebagai database layanan nama dan urutan di mana lingkungan run-time melakukan pencarian adalah sebagai berikut:

Cari di cache lokal.
Jika entri tidak ditemukan di cache lokal, cari Direktori Aktif mesin tersebut.
Jika entri tidak ditemukan di komputer lokal, kirim permintaan siaran ke semua layanan Direktori Aktif lainnya di domain.
Perhatikan bahwa jika entri ada di Direktori Aktif, tetapi tidak ada informasi yang terkait dengan entri, lingkungan run-time tidak akan mengeluarkan permintaan siaran ini.

Setelah selesai menemukan handel pengikatan, aplikasi klien memanggil fungsi RpcNsBindingLookupDone untuk menghapus konteks pencarian.

Catatan

Header rpcnsi.h mendefinisikan RpcNsBindingLookupBegin 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 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

RpcNsBindingLookupDone

RpcNsBindingLookupNext

Bagikan melalui