Fungsi RpcNsProfileEltRemoveA (rpcnsi.h)

Artikel
03/01/2024

Fungsi RpcNsProfileEltRemove menghapus elemen dari profil.

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

Sintaks

RPC_STATUS RpcNsProfileEltRemoveA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

Parameter

ProfileNameSyntax

Sintaks ProfileName.

Untuk menggunakan sintaks yang ditentukan dalam entri nilai registri HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, berikan nilai RPC_C_NS_SYNTAX_DEFAULT.

ProfileName

Arahkan ke nama profil untuk menghapus elemen.

IfId

Arahkan ke identifikasi antarmuka elemen profil yang akan dihapus.

Tentukan nilai null untuk menghapus anggota profil default.

MemberNameSyntax

Sintaks MemberName.

Untuk menggunakan sintaks yang ditentukan dalam entri nilai registri HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, berikan nilai RPC_C_NS_SYNTAX_DEFAULT.

MemberName

Arahkan ke nama service–entry name di elemen profil untuk dihapus.

Mengembalikan nilai

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.

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

Keterangan

Fungsi RpcNsProfileEltRemove menghapus elemen profil dari atribut profil di entri ProfileName . Fungsi ini memerlukan kecocokan yang tepat dari parameter MemberName dan IfId untuk menghapus elemen profil. Entri (MemberName), yang disertakan sebagai anggota dalam elemen profil, tidak dihapus.

Catatan Gunakan RpcNsProfileEltRemove dengan hati-hati: menghapus elemen dari profil dapat memiliki efek yang tidak diinginkan dari melanggar hierarki profil.

Catatan Direktori Aktif Windows 2000 mendukung fungsi ini. Versi Windows NT yang lebih lama mendukung penggunaan fungsi ini hanya dengan Layanan Direktori Sel (CDS).

Catatan

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

RpcNsProfileDelete

RpcNsProfileEltAdd

Bagikan melalui