Fungsi RpcNsProfileEltInqNextA (rpcnsi.h)

Artikel
03/15/2023

Fungsi RpcNsProfileEltInqNext mengembalikan satu elemen pada satu waktu dari profil.

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

Sintaks

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

Parameter

InquiryContext

Handel layanan nama yang dikembalikan dari fungsi RpcNsProfileEltInqBegin .

IfId

Mengembalikan penunjuk ke identifikasi antarmuka elemen profil.

MemberName

Mengembalikan penunjuk ke penunjuk ke nama anggota elemen profil. Sintaks nama yang dikembalikan ditentukan oleh parameter MemberNameSyntax dalam fungsi RpcNsProfileEltInqBegin .

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

Priority

Mengembalikan penunjuk ke prioritas elemen profil.

Annotation

Mengembalikan penunjuk ke penunjuk ke string anotasi untuk elemen profil. Jika tidak ada string anotasi di elemen profil, string \0 dikembalikan.

Tentukan nilai null untuk mencegah RpcNsProfileEltInqNext mengembalikan parameter Anotasi . Dalam hal ini, aplikasi tidak perlu memanggil fungsi RpcStringFree .

Mengembalikan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INCOMPLETE_NAME	Nama tidak lengkap.
RPC_S_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.
RPC_S_NO_MORE_ELEMENTS	Tidak ada lagi elemen.

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

Keterangan

Fungsi RpcNsProfileEltInqNext mengembalikan satu elemen dari profil yang ditentukan oleh parameter ProfileName di RpcNsProfileEltInqBegin. Terlepas dari nilai InquiryType di RpcNsProfileEltInqBegin, RpcNsProfileEltInqNext mengembalikan semua komponen (identifikasi antarmuka, nama anggota, prioritas, string anotasi) dari elemen profil.

Aplikasi dapat melihat semua entri profil yang dipilih dengan berulang kali memanggil fungsi RpcNsProfileEltInqNext . Ketika semua elemen telah dilihat, fungsi ini mengembalikan kode status RPC_S_NO_MORE_ELEMENTS. Elemen yang dikembalikan tidak diurutkan.

Pada setiap panggilan ke RpcNsProfileEltInqNext yang mengembalikan elemen profil, pustaka run-time RPC mengalokasikan memori untuk nama anggota dan string anotasi yang dikembalikan. Aplikasi ini bertanggung jawab untuk memanggil fungsi RpcStringFree untuk setiap nama anggota dan string anotasi yang dikembalikan. Setelah melihat elemen profil, aplikasi harus memanggil RpcNsProfileEltInqDone untuk merilis konteks pertanyaan.

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

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

Bagikan melalui