Fungsi RpcNsProfileEltInqNextW (rpcnsi.h)
Fungsi RpcNsProfileEltInqNext mengembalikan satu elemen pada satu waktu dari profil.
Sintaks
RPC_STATUS RpcNsProfileEltInqNextW(
RPC_NS_HANDLE InquiryContext,
RPC_IF_ID *IfId,
RPC_WSTR *MemberName,
unsigned long *Priority,
RPC_WSTR *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 .
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
|
Nama tidak lengkap. |
|
Layanan nama tidak tersedia. |
|
Tidak ada lagi elemen. |
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
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk