Fungsi RpcNsBindingImportBeginA (rpcnsi.h)

  • Artikel

Fungsi RpcNsBindingImportBegin membuat konteks impor untuk mengimpor handel pengikatan yang kompatibel dengan klien untuk server yang menawarkan antarmuka dan objek yang ditentukan.

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

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
RPC_S_OK
 Panggilan berhasil.
RPC_S_INVALID_NAME_SYNTAX
 Sintaks nama tidak valid.
RPC_S_NAME_SERVICE_UNAVAILABLE
 Nama melebihi panjang maksimum.
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

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

Lihat juga

RpcNsBindingImportDone

RpcNsBindingImportNext