Fungsi MappingGetServices (elscore.h)
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.
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 |
Lihat juga
Menghitung dan Membebaskan Layanan
Layanan Linguistik yang Diperluas