RpcNsGroupMbrInqNextA (rpcnsi.h)

Artikel
03/15/2023

Fungsi RpcNsGroupMbrInqNext mengembalikan satu nama entri dari grup dalam satu waktu.

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

Sintaks

RPC_STATUS RpcNsGroupMbrInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_CSTR      *MemberName
);

Parameter

InquiryContext

Handel layanan nama.

MemberName

Mengembalikan alamat penunjuk ke nama anggota grup RPC. Sintaks nama yang dikembalikan ditentukan oleh parameter MemberNameSyntax dalam fungsi RpcNsGroupMbrInqBegin .

Tentukan nilai null untuk mencegah RpcNsGroupMbrInqNext mengembalikan parameter MemberName . Dalam hal ini, aplikasi tidak memanggil fungsi RpcStringFree .

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_NS_HANDLE	Handel layanan-nama tidak valid.
RPC_S_NO_MORE_MEMBERS	Tidak ada lagi anggota.
RPC_S_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.

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

Keterangan

Fungsi RpcNsGroupMbrInqNext mengembalikan satu anggota grup RPC yang ditentukan oleh parameter GroupName di RpcNsGroupMbrInqBegin. Aplikasi dapat melihat semua anggota grup RPC yang ditetapkan dengan berulang kali memanggil RpcNsGroupMbrInqNext. Ketika semua anggota grup telah dilihat, fungsi ini mengembalikan kode status RPC_S_NO_MORE_MEMBERS. Anggota grup yang dikembalikan tidak diurutkan.

Pada setiap panggilan ke RpcNsGroupMbrInqNext yang mengembalikan nama anggota, pustaka run-time RPC mengalokasikan memori untuk MemberName yang dikembalikan. Aplikasi ini bertanggung jawab untuk memanggil RpcStringFree untuk setiap string MemberName yang dikembalikan. Setelah melihat anggota grup RPC, aplikasi harus memanggil RpcNsGroupMbrInqDone untuk merilis konteks pertanyaan.

Urutan di mana anggota grup dikembalikan dapat berbeda untuk setiap tampilan grup. Ini berarti bahwa urutan di mana anggota grup dikembalikan ke aplikasi dapat berbeda setiap kali aplikasi dijalankan.

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

Catatan

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


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

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree

Bagikan melalui