Fungsi RpcNsMgmtBindingUnexportW (rpcnsi.h)

Artikel
08/25/2023

Fungsi RpcNsMgmtBindingUnexport menghapus beberapa handel pengikatan dan objek dari entri dalam database layanan nama.

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

Sintaks

RPC_STATUS RpcNsMgmtBindingUnexportW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  UUID_VECTOR   *ObjectUuidVec
);

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.

IfId

Arahkan ke identifikasi antarmuka. Nilai parameter null menunjukkan bahwa handel pengikatan tidak boleh tidak didukung—hanya UUID objek yang tidak boleh diekspor.

VersOption

Menentukan bagaimana fungsi RpcNsMgmtBindingUnexport menggunakan anggota VersMajor dan VersMinor dari struktur yang ditunjukkan oleh parameter IfId .

Tabel berikut ini menjelaskan nilai yang valid untuk parameter VersOption .

Nilai VersOption	Makna
RPC_C_VERS_ALL	Membatalkan ekspor semua pengikatan untuk antarmuka UUID di IfId, terlepas dari nomor versinya. Untuk nilai ini, tentukan 0 untuk versi utama dan minor di IfId.
RPC_C_VERS_IF_ID	Membatalkan ekspor pengikatan untuk antarmuka UUID yang kompatibel di IfId dengan versi utama yang sama dan dengan versi minor yang lebih besar dari atau sama dengan versi minor di IfId.
RPC_C_VERS_EXACT	Membatalkan ekspor pengikatan untuk antarmuka UUID di IfId dengan versi mayor dan minor yang sama seperti dalam IfId.
RPC_C_VERS_MAJOR_ONLY	Membatalkan ekspor pengikatan untuk antarmuka UUID di IfId dengan versi utama yang sama seperti di IfId (mengabaikan versi minor). Untuk nilai ini, tentukan 0 untuk versi minor di IfId.
RPC_C_VERS_UPTO	Membatalkan ekspor pengikatan yang menawarkan versi antarmuka UUID yang ditentukan kurang dari atau sama dengan versi utama dan minor yang ditentukan. (Misalnya, jika IfId berisi V2.0 dan entri layanan-database nama yang berisi handel pengikatan dengan versi 1.3, 2.0, dan 2.1, fungsi RpcNsMgmtBindingUnexport tidak akan mengekspor handel pengikatan dengan versi 1.3 dan 2.0.)

ObjectUuidVec

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 boleh diekspor.

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 RpcNsMgmtBindingUnexport memungkinkan aplikasi manajemen untuk menghapus salah satu hal berikut dari entri layanan-database nama:

Semua handel pengikatan untuk antarmuka UUID tertentu, memenuhi syarat oleh nomor versi antarmuka (mayor dan minor)
Satu atau beberapa UUID objek sumber daya
Handel pengikatan dan UUID objek sumber daya

Aplikasi manajemen dapat membatalkan ekspor antarmuka dan objek dalam satu panggilan ke RpcNsMgmtBindingUnexport, atau dapat membatalkan ekspornya secara terpisah. Jika RpcNsMgmtBindingUnexport tidak menemukan handel pengikatan untuk antarmuka yang ditentukan, fungsi mengembalikan kode status RPC_S_INTERFACE_NOT_FOUND dan tidak membatalkan ekspor UUID objek, jika ada yang ditentukan.

Jika satu atau beberapa handel pengikatan untuk antarmuka yang ditentukan ditemukan dan tidak didukung tanpa kesalahan, RpcNsMgmtBindingUnexport tidak mengeksport UUID objek tertentu. Jika salah satu UUID objek yang ditentukan tidak ditemukan, RpcNsMgmtBindingUnexport mengembalikan RPC_S_NOT_ALL_OBJS_UNEXPORTED.

Selain memanggil RpcNsMgmtBindingUnexport, aplikasi manajemen juga harus memanggil fungsi RpcMgmtEpUnregister untuk membatalkan pendaftaran server yang telah terdaftar di database endpoint-map.

Catatan Database layanan nama dirancang agar relatif stabil. Dalam layanan nama yang direplikasi, penggunaan fungsi RpcNsBindingExport dan RpcNsBindingUnexport yang sering menyebabkan layanan nama berulang kali menghapus dan mengganti entri yang sama, yang dapat menyebabkan masalah performa.

Catatan

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

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

RpcMgmtEpUnregister

RpcNsBindingExport

RpcNsBindingUnexport

Bagikan melalui