Fungsi RpcMgmtEpEltInqNextW (rpcdce.h)

Fungsi RpcMgmtEpEltInqNext mengembalikan satu elemen dari peta titik akhir.

Sintaksis

RPC_STATUS RpcMgmtEpEltInqNextW(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_WSTR           *Annotation
);

Parameter

InquiryContext

Menentukan konteks pertanyaan. Konteks pertanyaan dikembalikan dari RpcMgmtEpEltInqBegin.

IfId

Mengembalikan pengidentifikasi antarmuka elemen peta titik akhir.

Binding

Fakultatif. Mengembalikan handel pengikatan dari elemen endpoint-map.

ObjectUuid

Fakultatif. Mengembalikan UUID objek dari elemen peta titik akhir.

Annotation

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

Mengembalikan nilai

Nilai	Arti
RPC_S_OK	Panggilan berhasil.

 

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

 

Komentar

Fungsi RpcMgmtEpEltInqNext mengembalikan satu elemen dari peta titik akhir. Elemen yang dipilih bergantung pada konteks pertanyaan. Kriteria pemilihan 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 setiapAnotasi 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 praprosepsi 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone