次の方法で共有


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

こちらもご覧ください

サービスの列挙と解放

拡張言語サービス

拡張言語サービス関数

MAPPING_ENUM_OPTIONS

MAPPING_SERVICE_INFO

MappingFreeServices