RpcMgmtEpEltInqNext (rpcdce.h)

Artikel
03/01/2024

Fungsi RpcMgmtEpEltInqNext mengembalikan satu elemen dari peta titik akhir.

Sintaks

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  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.

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.

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

Share via