Fungsi RpcNsMgmtBindingUnexportA (rpcnsi.h)
Fungsi RpcNsMgmtBindingUnexport menghapus beberapa handel pengikatan dan objek dari entri dalam database layanan nama.
Sintaks
RPC_STATUS RpcNsMgmtBindingUnexportA(
unsigned long EntryNameSyntax,
RPC_CSTR 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 .
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 didukung.
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
|
Opsi versi tidak valid. |
|
Sintaks nama tidak valid. |
|
Sintaks nama tidak didukung. |
|
Nama tidak lengkap. |
|
Entri layanan-nama tidak ditemukan. |
|
Layanan nama tidak tersedia. |
|
Antarmuka tidak ditemukan. |
|
Tidak semua objek tidak didukung. |
Keterangan
Fungsi RpcNsMgmtBindingUnexport memungkinkan aplikasi manajemen untuk menghapus salah satu hal berikut ini dari entri layanan nama–database:
- Semua handel pengikatan untuk antarmuka UUID tertentu, memenuhi syarat oleh nomor versi antarmuka (utama dan minor)
- Satu atau beberapa UUID objek sumber daya
- Handel pengikatan dan UUID objek sumber daya
Jika satu atau beberapa handel pengikatan untuk antarmuka yang ditentukan ditemukan dan tidak didukung tanpa kesalahan, RpcNsMgmtBindingUnexport tidak mendukung 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 titik akhir-peta.
Catatan
Header rpcnsi.h mendefinisikan RpcNsMgmtBindingUnexport 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 |