共用方式為


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

另請參閱

列舉和釋放服務

擴充語言服務

擴充語言服務函式

MAPPING_ENUM_OPTIONS

MAPPING_SERVICE_INFO

MappingFreeServices