Fungsi RpcNsBindingExportPnPA (rpcnsi.h)

Artikel
03/15/2023

Fungsi RpcNsBindingExportPnP menetapkan entri database layanan nama dengan beberapa handel pengikatan dan beberapa objek untuk server yang mendukung Plug and Play.

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

Sintaks

RPC_STATUS RpcNsBindingExportPnPA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID_VECTOR   *ObjectVector
);

Parameter

EntryNameSyntax

Sintaks 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

Arahkan ke nama entri tempat handel pengikatan dan UUID objek diekspor. Anda tidak dapat menyediakan string null atau kosong.

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 data yang dihasilkan stub yang menentukan antarmuka yang akan diekspor. Nilai null menunjukkan tidak ada handel pengikatan untuk diekspor (hanya UUID objek yang akan diekspor) dan BindingVec diabaikan.

ObjectVector

Arahkan ke vektor UUID objek yang ditawarkan oleh server. Aplikasi server membangun vektor ini. Nilai null menunjukkan tidak ada UUID objek untuk diekspor (hanya handel pengikatan yang akan diekspor).

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_NOTHING_TO_EXPORT	Tidak ada yang perlu diekspor.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.
RPC_S_WRONG_KIND_OF_BINDING	Ini adalah jenis pengikatan yang salah untuk operasi.
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_NO_NS_PRIVILEGE	Tidak ada hak istimewa untuk operasi layanan nama.
RPC_S_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.

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

Keterangan

Fungsi RpcNsBindingExportPnP memungkinkan aplikasi server untuk secara publik menawarkan antarmuka dalam database layanan nama yang mendukung pengikatan Plug and Play untuk digunakan oleh aplikasi klien apa pun.

Perhatikan bahwa aplikasi server tidak boleh secara eksplisit menyediakan vektor pengikatan saat mengekspor pengikatan Plug and Play. Pengikatan diperbarui secara otomatis ketika ada perubahan dalam pengikatan karena peristiwa Plug and Play.

Catatan

Header rpcnsi.h mendefinisikan RpcNsBindingExportPnP sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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

RpcNsBindingExport

RpcNsBindingUnexportPnP

Bagikan melalui