Fungsi RpcNsProfileEltAddW (rpcnsi.h)

Artikel
03/15/2023

Fungsi RpcNsProfileEltAdd menambahkan elemen ke profil. Jika perlu, entri akan dibuat.

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

Sintaks

RPC_STATUS RpcNsProfileEltAddW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName,
  unsigned long Priority,
  RPC_WSTR      Annotation
);

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 menerima elemen baru.

IfId

Arahkan ke identifikasi antarmuka elemen profil baru. Untuk menambahkan atau mengganti elemen profil default, tentukan nilai null.

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 layanan–nama entri untuk disertakan dalam elemen profil baru.

Priority

Nilai bilangan bulat (0 hingga 7) yang menunjukkan prioritas relatif untuk menggunakan elemen profil baru selama operasi impor dan pencarian. Nilai 0 adalah prioritas tertinggi; nilai 7 adalah prioritas terendah. Saat menambahkan anggota profil default, gunakan nilai 0.

Annotation

Penunjuk ke string anotasi yang disimpan sebagai bagian dari elemen profil baru. Tentukan nilai null atau string null-terminated jika tidak ada string anotasi.

String hanya digunakan oleh aplikasi untuk tujuan informasi. Misalnya, aplikasi dapat menggunakan string ini untuk menyimpan string nama antarmuka yang ditentukan dalam file IDL. RPC tidak menggunakan string anotasi selama operasi pencarian atau impor atau untuk menghitung elemen profil.

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_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.

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

Keterangan

Fungsi RpcNsProfileEltAdd menambahkan elemen ke atribut profil entri name-service yang ditentukan oleh ProfileName. Jika entri ProfileName tidak ada, RpcNsProfileEltAdd mencoba membuat entri dengan atribut profil dan menambahkan elemen profil yang ditentukan oleh parameter IfId, MemberName, Priority, dan Anotasi . Dalam hal ini, aplikasi harus memiliki hak istimewa untuk membuat entri. Jika tidak, aplikasi manajemen dengan hak istimewa yang diperlukan harus membuat entri dengan memanggil fungsi RpcNsMgmtEntryCreate sebelum aplikasi dijalankan.

Jika elemen dengan nama anggota dan identifikasi antarmuka yang ditentukan sudah ada di profil, RpcNsProfileEltAdd memperbarui prioritas elemen dan string anotasi menggunakan nilai yang disediakan dalam parameter Prioritas dan Anotasi .

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 RpcNsProfileEltAdd 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

RpcIfInqId

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove

Bagikan melalui