Fungsi RpcNsBindingLookupBeginA (rpcnsi.h)
Fungsi RpcNsBindingLookupBegin membuat konteks pencarian untuk antarmuka dan objek.
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 |
---|---|
|
Panggilan berhasil. |
|
Sintaks nama tidak valid. |
|
Sintaks nama tidak didukung. |
|
Nama tidak lengkap. |
|
Entri layanan-nama tidak ditemukan. |
|
Layanan nama tidak tersedia. |
|
Objek tidak valid. |
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.
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 |