mappingGetServices 函数 (elscore.h)
根据应用程序指定的条件检索可用 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
指向包含与 pOptions 参数中提供的条件匹配的服务信息的MAPPING_SERVICE_INFO结构的数组的指针的地址。
[out] pdwServicesCount
指向此函数检索检索到的服务数的 DWORD 变量的指针。
返回值
如果成功，则返回S_OK。 如果函数不成功，则返回错误 HRESULT 值。
注意 在继续执行进一步操作之前，应用程序必须测试是否有任何故障。
注解
ELS 应用程序可以检索所有服务，也可以根据指定的选项筛选服务。 有关关联的过程和代码示例，请参阅 枚举和释放服务。
为了避免资源泄漏，应用程序必须通过调用 MappingFreeServices 释放 prgServices 指示的指针。
出于性能原因，建议不经常检索服务。 例如，如果应用程序需要特定服务（通过 GUID），则可以在需要时对其进行枚举并缓存以供将来使用。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | elscore.h |
| Library | Elscore.lib |
| DLL | Elscore.dll |