Fungsi RpcNsEntryObjectInqNext (rpcnsi.h)

Artikel
03/15/2023

Fungsi RpcNsEntryObjectInqNext mengembalikan satu objek pada satu waktu dari entri database layanan nama.

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

Sintaks

RPC_STATUS RpcNsEntryObjectInqNext(
  RPC_NS_HANDLE InquiryContext,
  UUID          *ObjUuid
);

Parameter

InquiryContext

Handel layanan nama yang menunjukkan UUID objek untuk entri database layanan nama.

ObjUuid

Mengembalikan penunjuk ke UUID objek yang diekspor.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_NO_MORE_MEMBERS	Tidak ada lagi anggota.
RPC_S_INCOMPLETE_NAME	Nama tidak lengkap.
RPC_S_ENTRY_NOT_FOUND	Entri layanan-nama tidak ditemukan.
RPC_S_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.

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

Keterangan

Fungsi RpcNsEntryObjectInqNext mengembalikan salah satu UUID objek yang diekspor ke entri database layanan nama yang ditentukan oleh parameter EntryName dalam fungsi RpcNsEntryObjectInqBegin .

Aplikasi dapat melihat semua UUID objek yang diekspor dengan berulang kali memanggil RpcNsEntryObjectInqNext. Ketika semua UUID objek telah dilihat, fungsi ini mengembalikan kode status RPC_S_NO_MORE_MEMBERS. UUID objek yang dikembalikan tidak diurutkan.

Aplikasi ini memasok memori untuk UUID objek yang dikembalikan dalam parameter ObjUuid .

Setelah melihat UUID objek, aplikasi harus memanggil fungsi RpcNsEntryObjectInqDone untuk merilis konteks pertanyaan.

Urutan di mana UUID objek dikembalikan dapat berbeda untuk setiap tampilan entri. Ini berarti bahwa urutan UUID objek dikembalikan ke aplikasi dapat berbeda setiap kali aplikasi dijalankan.

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

RpcNsBindingExport

RpcNsEntryObjectInqBegin

RpcNsEntryObjectInqDone

Bagikan melalui