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 |