Fungsi RpcNsMgmtEntryDeleteA (rpcnsi.h)

Artikel
08/25/2023

Fungsi RpcNsMgmtEntryDelete menghapus entri nama layanan–database.

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

Sintaks

RPC_STATUS RpcNsMgmtEntryDeleteA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName
);

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 yang akan dihapus.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
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_NOT_RPC_ENTRY	Bukan entri RPC.

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

Keterangan

Aplikasi manajemen menggunakan fungsi RpcNsMgmtEntryDelete hanya ketika entri tidak lagi diperlukan—misalnya, ketika server dihapus secara permanen dari layanan.

Karena database layanan nama dirancang agar relatif stabil, penggunaan RpcNsMgmtEntryDelete yang sering di aplikasi klien atau server dapat mengakibatkan masalah performa. Membuat dan menghapus entri dalam aplikasi klien atau server menyebabkan database layanan nama berulang kali menghapus dan mengganti entri yang sama. Ini dapat menyebabkan masalah performa dalam database layanan nama yang direplikasi.

Catatan

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

RpcNsMgmtEntryCreate

Bagikan melalui