Fungsi MappingGetServices (elscore.h)

Artikel
02/29/2024

Mengambil daftar layanan yang didukung platform ELS yang tersedia, bersama dengan informasi terkait, sesuai dengan kriteria yang ditentukan aplikasi.

Sintaks

HRESULT MappingGetServices(
  [in, optional] PMAPPING_ENUM_OPTIONS pOptions,
  [out]          PMAPPING_SERVICE_INFO *prgServices,
  [out]          DWORD                 *pdwServicesCount
);

Parameter

[in, optional] pOptions

Penunjuk ke struktur MAPPING_ENUM_OPTIONS yang berisi kriteria untuk digunakan selama enumerasi layanan. Aplikasi menentukan NULL untuk parameter ini untuk mengambil semua layanan yang diinstal.

[out] prgServices

Alamat penunjuk ke array struktur MAPPING_SERVICE_INFO yang berisi informasi layanan yang cocok dengan kriteria yang disediakan dalam parameter pOptions .

[out] pdwServicesCount

Penunjuk ke variabel DWORD tempat fungsi ini mengambil jumlah layanan yang diambil.

Nilai kembali

Mengembalikan S_OK jika berhasil. Fungsi mengembalikan nilai HRESULT kesalahan jika tidak berhasil.

Catatan Aplikasi harus menguji kegagalan apa pun sebelum melanjutkan operasi lebih lanjut.

Keterangan

Aplikasi ELS dapat mengambil semua layanan atau memfilter layanan sesuai dengan opsi yang ditentukan. Untuk prosedur terkait dan sampel kode, lihat Menghitung dan Membebaskan Layanan.

Untuk menghindari kebocoran sumber daya, aplikasi harus membebaskan pointer yang ditunjukkan oleh prgServices dengan panggilan ke MappingFreeServices.

Untuk alasan performa, disarankan untuk jarang mengambil layanan. Misalnya, jika aplikasi membutuhkan layanan tertentu, oleh GUID, aplikasi dapat dijumlahkan saat diperlukan dan di-cache untuk digunakan di masa mendatang.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	elscore.h
Pustaka	Elscore.lib
DLL	Elscore.dll