Fungsi RpcNsGroupMbrAddW (rpcnsi.h)

Artikel
08/25/2023

Fungsi RpcNsGroupMbrAdd menambahkan nama entri ke grup. Jika perlu, entri akan dibuat.

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

Sintaks

RPC_STATUS RpcNsGroupMbrAddW(
  unsigned long GroupNameSyntax,
  RPC_WSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName
);

Parameter

GroupNameSyntax

Sintaks GroupName.

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

GroupName

Arahkan ke nama grup RPC untuk menerima anggota baru.

MemberNameSyntax

Sintaks untuk digunakan di 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 kursor ke nama anggota grup RPC baru.

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

RpcNsGroupMbrAdd menambahkan nama entri layanan–database sebagai anggota ke atribut grup RPC.

Jika entri GroupName tidak ada, RpcNsGroupMbrAdd mencoba membuat entri dengan atribut grup dan menambahkan anggota grup yang ditentukan oleh MemberName. 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 RpcNsMgmtEntryCreate sebelum aplikasi dijalankan.

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

RpcNsGroupMbrRemove

RpcNsMgmtEntryCreate

Bagikan melalui