Функция MappingGetServices (elscore.h)

Статья
02/29/2024

Извлекает список доступных служб, поддерживаемых платформой ELS, а также связанные сведения в соответствии с критериями, заданными приложением.

Синтаксис

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

Параметры

[in, optional] pOptions

Указатель на MAPPING_ENUM_OPTIONS структуру, содержащую критерии для использования во время перечисления служб. Приложение задает значение NULL для этого параметра, чтобы получить все установленные службы.

[out] prgServices

Адрес указателя на массив MAPPING_SERVICE_INFO структур, содержащих сведения о службе, соответствующие условиям, указанным в параметре pOptions .

[out] pdwServicesCount

Указатель на переменную DWORD, в которой эта функция извлекает количество полученных служб.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK. Функция возвращает значение HRESULT ошибки, если не удалось.

Примечание Приложение должно проверить наличие сбоя перед продолжением дальнейших операций.

Приложение ELS может получить все службы или отфильтровать службы в соответствии с указанными параметрами. Сведения о связанной процедуре и примере кода см. в разделе Перечисление и освобождение служб.

Чтобы избежать утечек ресурсов, приложение должно освободить указатель, указанный prgServices , с помощью вызова MappingFreeServices.

По соображениям производительности рекомендуется получать службы нечасто. Например, если приложению требуется определенная служба с помощью GUID, ее можно перечислить при необходимости и кэшировать для использования в будущем.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	elscore.h
Библиотека	Elscore.lib
DLL	Elscore.dll