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
陣列 MAPPING_SERVICE_INFO 結構的指標位址,其中包含符合 pOptions 參數中提供之準則的服務資訊。
[out] pdwServicesCount
此函式擷取擷取所擷取服務數目的 DWORD 變數指標。
傳回值
如果成功,則傳回S_OK。 如果失敗,函式會傳回錯誤 HRESULT 值。
注意 應用程式必須測試是否有任何失敗,才能繼續進行進一步的作業。
備註
ELS 應用程式可以根據指定的選項擷取所有服務或篩選服務。 如需相關聯的程式和程式代碼範例,請參閱 列舉和釋放服務。
若要避免資源流失,應用程式必須釋放 prgServices 所指出的指標,並呼叫 MappingFreeServices。
基於效能考慮,建議您不常擷取服務。 例如,如果應用程式需要特定服務,則 GUID 可以視需要加以列舉,並快取以供日後使用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | elscore.h |
程式庫 | Elscore.lib |
Dll | Elscore.dll |