RpcMgmtEpEltInqNextA (rpcdce.h)

Artikel
03/01/2024

Fungsi RpcMgmtEpEltInqNext mengembalikan satu elemen dari peta titik akhir.

Sintaks

RPC_STATUS RpcMgmtEpEltInqNextA(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_CSTR           *Annotation
);

Parameter

InquiryContext

Menentukan konteks pertanyaan. Konteks pertanyaan dikembalikan dari RpcMgmtEpEltInqBegin.

IfId

Mengembalikan pengidentifikasi antarmuka elemen peta titik akhir.

Binding

Opsional. Mengembalikan handel pengikatan dari elemen peta titik akhir.

ObjectUuid

Pilihan. Mengembalikan UUID objek dari elemen peta titik akhir.

Annotation

Pilihan. Mengembalikan string anotasi untuk elemen peta titik akhir. Ketika tidak ada string anotasi dalam elemen peta titik akhir, string kosong ("") dikembalikan.

Mengembalikan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.

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

Keterangan

Fungsi RpcMgmtEpEltInqNext mengembalikan satu elemen dari peta titik akhir. Elemen yang dipilih bergantung pada konteks pertanyaan. Kriteria pilihan ditentukan oleh InquiryType dari fungsi RpcMgmtEpEltInqBegin yang mengembalikan InquiryContext.

Aplikasi dapat melihat semua elemen peta titik akhir yang dipilih dengan berulang kali memanggil RpcMgmtEpEltInqNext. Ketika semua elemen telah dilihat, fungsi ini mengembalikan status RPC_X_NO_MORE_ENTRIES. Elemen yang dikembalikan tidak diurutkan.

Ketika argumen masing-masing non-NULL, pustaka fungsi run-time RPC mengalokasikan memori untuk Pengikatan dan Anotasi pada setiap panggilan ke fungsi ini. Aplikasi ini bertanggung jawab untuk memanggil RpcBindingFree untuk setiap Pengikatan yang dikembalikan dan RpcStringFree untuk setiap Anotasi yang dikembalikan.

Setelah melihat elemen peta titik akhir, aplikasi harus memanggil RpcMgmtEpEltInqDone untuk menghapus konteks pertanyaan.

Catatan

Header rpcdce.h mendefinisikan RpcMgmtEpEltInqNext 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

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	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone

Bagikan melalui