mappingGetServices 函数 (elscore.h)

项目
02/26/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

指向包含与 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