Fungsi RpcMgmtEpEltInqBegin (rpcdce.h)

Artikel
08/25/2023

Fungsi RpcMgmtEpEltInqBegin membuat konteks pertanyaan untuk melihat elemen dalam peta titik akhir.

Sintaks

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

Parameter

EpBinding

Handel pengikatan ke host yang elemen peta titik akhirnya akan dilihat. Tentukan NULL untuk melihat elemen dari host lokal. Jika handel pengikatan ditentukan, UUID objek pada handel pengikatan harus NULL. Jika ada, titik akhir pada handel pengikatan diabaikan dan titik akhir ke database pemeta titik akhir pada host yang diberikan digunakan.

InquiryType

Nilai bilangan bulat yang menunjukkan jenis pertanyaan yang akan dilakukan pada peta titik akhir. Berikut ini adalah jenis pertanyaan yang valid.

Nilai	Makna
RPC_C_EP_ALL_ELTS	Mengembalikan setiap elemen dari peta titik akhir. Parameter IfId, VersOption, dan ObjectUuid diabaikan.
RPC_C_EP_MATCH_BY_IF	Mencari peta titik akhir untuk elemen yang berisi pengidentifikasi antarmuka yang ditentukan oleh nilai IfId dan VersOption .
RPC_C_EP_MATCH_BY_OBJ	Mencari peta titik akhir untuk elemen yang berisi UUID objek yang ditentukan oleh ObjectUuid.
RPC_C_EP_MATCH_BY_BOTH	Mencari peta titik akhir untuk elemen yang berisi pengidentifikasi antarmuka dan UUID objek yang ditentukan oleh IfId, VersOption, dan ObjectUuid.

IfId

Pengidentifikasi antarmuka elemen peta titik akhir yang akan dikembalikan oleh RpcMgmtEpEltInqNext. Parameter ini hanya digunakan ketika InquiryType RPC_C_EP_MATCH_BY_IF atau RPC_C_EP_MATCH_BY_BOTH. Jika tidak, itu diabaikan.

VersOption

Menentukan bagaimana RpcMgmtEpEltInqNext menggunakan parameter IfId . Parameter ini hanya digunakan ketika InquiryType RPC_C_EP_MATCH_BY_IF atau RPC_C_EP_MATCH_BY_BOTH. Jika tidak, itu diabaikan. Berikut ini adalah nilai yang valid untuk parameter ini.

Nilai	Makna
RPC_C_VERS_ALL	Mengembalikan elemen peta titik akhir yang menawarkan antarmuka UUID yang ditentukan, terlepas dari nomor versinya.
RPC_C_VERS_COMPATIBLE	Mengembalikan elemen peta titik akhir yang menawarkan versi utama yang sama dari antarmuka UUID yang ditentukan dan versi minor yang lebih besar dari atau sama dengan versi minor antarmuka UUID yang ditentukan.
RPC_C_VERS_EXACT	Mengembalikan elemen peta titik akhir yang menawarkan versi UUID antarmuka yang ditentukan.
RPC_C_VERS_MAJOR_ONLY	Mengembalikan elemen peta titik akhir yang menawarkan versi utama yang sama dari antarmuka UUID yang ditentukan dan mengabaikan versi minor.
RPC_C_VERS_UPTO	Mengembalikan elemen peta titik akhir yang menawarkan versi antarmuka UUID yang ditentukan kurang dari atau sama dengan versi utama dan minor yang ditentukan.

ObjectUuid

UUID objek yang dicari RpcMgmtEpEltInqNext dalam elemen peta titik akhir. Parameter ini hanya digunakan ketika InquiryType RPC_C_EP_MATCH_BY_OBJ atau RPC_C_EP_MATCH_BY_BOTH.

InquiryContext

Mengembalikan konteks pertanyaan untuk digunakan dengan RpcMgmtEpEltInqNext dan RpcMgmtEpEltInqDone. Lihat RPC_EP_INQ_HANDLE.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.

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

Keterangan

Fungsi RpcMgmtEpEltInqBegin membuat konteks pertanyaan untuk melihat informasi alamat server yang disimpan di peta titik akhir. Menggunakan InquiryType dan VersOption, aplikasi menentukan elemen peta titik akhir berikut mana yang akan dikembalikan dari panggilan ke RpcMgmtEpEltInqNext:

Semua elemen
Elemen-elemen tersebut dengan pengidentifikasi antarmuka yang ditentukan
Elemen-elemen tersebut dengan UUID objek yang ditentukan
Elemen-elemen tersebut dengan pengidentifikasi antarmuka dan UUID objek yang ditentukan

Sebelum memanggil RpcMgmtEpEltInqNext, aplikasi harus terlebih dahulu memanggil fungsi ini untuk membuat konteks pertanyaan. Setelah melihat elemen peta titik akhir, aplikasi 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

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext

Bagikan melalui