MappingGetServices 関数 (elscore.h)

[アーティクル]
03/05/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