Fungsi RpcNsBindingUnexportPnPA (rpcnsi.h)

Artikel
03/01/2024

Fungsi RpcNsBindingUnexportPnP menghapus handel pengikatan untuk antarmuka dan objek Plug and Play dari entri dalam database layanan nama.

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

Sintaks

RPC_STATUS RpcNsBindingUnexportPnPA(
  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 untuk menghapus handel pengikatan dan UUID objek.

IfSpec

Spesifikasi antarmuka untuk handel pengikatan yang akan dihapus dari database layanan nama. Nilai parameter null menunjukkan untuk tidak membatalkan ekspor handel pengikatan apa pun (hanya UUID objek yang tidak didukung).

ObjectVector

Arahkan ke vektor UUID objek yang tidak lagi ingin ditawarkan server. Aplikasi membangun vektor ini. Nilai null menunjukkan tidak ada UUID objek yang tidak diekspor (hanya handel pengikatan yang tidak didukung).

Mengembalikan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_VERS_OPTION	Opsi versi tidak valid.
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_INTERFACE_NOT_FOUND	Antarmuka tidak ditemukan.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	Tidak semua objek tidak didukung.

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

Keterangan

Fungsi RpcNsBindingUnexportPnP memungkinkan aplikasi server untuk menghapus handel pengikatan dan UUID objek sumber daya yang kompatibel dengan Plug and Play dari entri database layanan nama. Aplikasi server dapat membatalkan ekspor antarmuka dan objek yang ditentukan dalam satu panggilan ke RpcNsBindingUnexportPnP, atau dapat membatalkan ekspornya secara terpisah. Hanya handel pengikatan yang cocok dengan antarmuka UUID dan nomor versi antarmuka utama dan minor yang ditemukan dalam parameter IfSpec yang tidak didukung.

Catatan

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

RpcNsBindingExportPnP

RpcNsBindingUnexport

Bagikan melalui