Fungsi RpcNsBindingImportBeginA (rpcnsi.h)
Fungsi RpcNsBindingImportBegin membuat konteks impor untuk mengimpor handel pengikatan yang kompatibel dengan klien untuk server yang menawarkan antarmuka dan objek yang ditentukan.
Sintaks
RPC_STATUS RpcNsBindingImportBeginA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
RPC_NS_HANDLE *ImportContext
);
Parameter
EntryNameSyntax
Sintaks EntryName.
Untuk menggunakan sintaks yang ditentukan dalam entri nilai registri HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, tentukan RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Penunjuk ke nama entri tempat pencarian handel pengikatan yang kompatibel dimulai.
Untuk menggunakan nama entri yang ditentukan dalam entri nilai registri HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, berikan pointer null atau string kosong. Dalam hal ini, parameter EntryNameSyntax diabaikan dan pustaka run-time menggunakan sintaks default.
IfSpec
Struktur data yang dihasilkan stub menunjukkan antarmuka untuk diimpor. Jika spesifikasi antarmuka belum diekspor atau tidak menjadi perhatian pemanggil, tentukan nilai null untuk parameter ini. Dalam hal ini, pengikatan yang dikembalikan hanya dijamin dari urutan protokol yang kompatibel dan didukung dan berisi UUID objek yang ditentukan. Server yang dihubungi mungkin tidak mendukung antarmuka yang diinginkan.
ObjUuid
Penunjuk ke UUID objek opsional.
Untuk UUID bukan nol, handel pengikatan yang kompatibel dikembalikan dari entri hanya jika server telah mengekspor UUID objek yang ditentukan.
Ketika ObjUuid memiliki nilai pointer null atau UUID nihil, 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.
ImportContext
Handel layanan nama dikembalikan untuk digunakan dengan fungsi RpcNsBindingImportNext dan RpcNsBindingImportDone .
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
|
Sintaks nama tidak valid. |
|
Nama melebihi panjang maksimum. |
|
Sintaks nama tidak didukung. |
|
Nama tidak lengkap. |
|
Entri layanan-nama tidak ditemukan. |
|
Layanan nama tidak tersedia. |
|
Objek tidak valid. |
Keterangan
Sebelum memanggil fungsi RpcNsBindingImportNext , aplikasi klien harus terlebih dahulu memanggil RpcNsBindingImportBegin untuk membuat konteks impor. Parameter untuk fungsi ini mengontrol pengoperasian fungsi RpcNsBindingImportNext .
Setelah selesai mengimpor handel pengikatan, aplikasi klien memanggil fungsi RpcNsBindingImportDone untuk menghapus konteks impor.
Catatan
Header rpcnsi.h mendefinisikan RpcNsBindingImportBegin 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
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 |