ホーム › System.Com › ICatInformation

ICatInformation

COM

📘 Microsoft Learn (日本語) · English

IID0002e013-0000-0000-c000-000000000046継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

特定のクラスが実装または要求するカテゴリに関する情報、および指定したコンピューターに登録されているカテゴリに関する情報を取得します。

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT EnumCategories(DWORD lcid, IEnumCATEGORYINFO** ppenumCategoryInfo)

システムに登録されているコンポーネントカテゴリの列挙子を取得します。

lcid	DWORD	in	列挙されたカテゴリの szDescription を返す際に使用するロケールを要求します。通常、呼び出し元は GetUserDefaultLCID 関数から返された値を指定します。
ppenumCategoryInfo	IEnumCATEGORYINFO**	out	IEnumCATEGORYINFO インターフェイスへのポインターへのポインター。これを使用して、システムに登録されているコンポーネントカテゴリの CATID とローカライズされた説明文字列を列挙できます。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および S_OK を返すことができます。

vtbl 4 HRESULT GetCategoryDesc(GUID* rcatid, DWORD lcid, LPWSTR* pszDesc)

特定のカテゴリ ID に対応するローカライズされた説明文字列を取得します。

rcatid	GUID*	in	カテゴリ識別子。
lcid	DWORD	in	ロケール。
pszDesc	LPWSTR*	out	説明文字列へのポインターへのポインター。この文字列は、呼び出し元が CoTaskMemFree 関数を使用して解放する必要があります。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および S_OK に加えて、次の値を返すことができます。

戻りコード	説明
CAT_E_CATIDNOEXIST	カテゴリ ID rcatid が登録されていません。
CAT_E_NODESCRIPTION	指定したロケールに対する rcatid の説明文字列が存在しません。

vtbl 5 HRESULT EnumClassesOfCategories(DWORD cImplemented, GUID* rgcatidImpl, DWORD cRequired, GUID* rgcatidReq, IEnumGUID** ppenumClsid)

1 つ以上の指定したカテゴリ識別子を実装するクラスの列挙子を取得します。

cImplemented	DWORD	in	rgcatidImpl 配列内のカテゴリ ID の数。この値を 0 にすることはできません。この値が -1 の場合、実装するカテゴリに関係なく、クラスが列挙に含まれます。
rgcatidImpl	GUID*	in	カテゴリ識別子の配列。クラスが、指定されていないカテゴリ識別子を要求する場合、そのクラスは列挙に含まれません。
cRequired	DWORD	in	rgcatidReq 配列内のカテゴリ ID の数。この値は 0 にすることができます。この値が -1 の場合、要求するカテゴリに関係なく、クラスが列挙に含まれます。
rgcatidReq	GUID*	in	カテゴリ識別子の配列。
ppenumClsid	IEnumGUID**	out	IEnumCLSID インターフェイスポインターへのポインター。これを使用して、指定したカテゴリを実装するクラスの CLSID を列挙できます。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および S_OK を返すことができます。

vtbl 6 HRESULT IsClassOfCategories(GUID* rclsid, DWORD cImplemented, GUID* rgcatidImpl, DWORD cRequired, GUID* rgcatidReq)

クラスが 1 つ以上のカテゴリを実装しているかどうかを判定します。

rclsid	GUID*	in	クラス識別子。
cImplemented	DWORD	in	rgcatidImpl 配列内のカテゴリ ID の数。この値を 0 にすることはできません。この値が -1 の場合、実装するカテゴリはテストされません。
rgcatidImpl	GUID*	in	カテゴリ識別子の配列。クラスが rgcatidReq に列挙されていないカテゴリを要求する場合、そのクラスは列挙に含まれません。
cRequired	DWORD	in	rgcatidReq 配列内のカテゴリ ID の数。この値は 0 にすることができます。この値が -1 の場合、要求するカテゴリはテストされません。
rgcatidReq	GUID*	in	カテゴリ識別子の配列。

戻り値

クラス ID が指定したカテゴリのいずれかに該当する場合、戻り値は S_OK です。それ以外の場合は S_FALSE です。

vtbl 7 HRESULT EnumImplCategoriesOfClass(GUID* rclsid, IEnumGUID** ppenumCatid)

指定したクラスが実装する CATID の列挙子を取得します。

rclsid	GUID*	in	クラス ID。
ppenumCatid	IEnumGUID**	out	IEnumCATID インターフェイスポインターへのポインター。これを使用して、rclsid が実装する CATID を列挙できます。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および S_OK を返すことができます。

vtbl 8 HRESULT EnumReqCategoriesOfClass(GUID* rclsid, IEnumGUID** ppenumCatid)

指定したクラスが要求する CATID の列挙子を取得します。

rclsid	GUID*	in	クラス識別子。
ppenumCatid	IEnumGUID**	out	IEnumCATID インターフェイスポインターへのポインター。これを使用して、rclsid が要求する CATID を列挙できます。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、および S_OK を返すことができます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ICatInformation "{0002E013-0000-0000-C000-000000000046}"
#usecom global ICatInformation IID_ICatInformation "{}"
#comfunc global ICatInformation_EnumCategories             3 int,sptr
#comfunc global ICatInformation_GetCategoryDesc            4 var,int,var
#comfunc global ICatInformation_EnumClassesOfCategories    5 int,var,int,var,sptr
#comfunc global ICatInformation_IsClassOfCategories        6 var,int,var,int,var
#comfunc global ICatInformation_EnumImplCategoriesOfClass  7 var,sptr
#comfunc global ICatInformation_EnumReqCategoriesOfClass   8 var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ICatInformation "{0002E013-0000-0000-C000-000000000046}"
#usecom global ICatInformation IID_ICatInformation "{}"
#comfunc global ICatInformation_EnumCategories             3 int,sptr
#comfunc global ICatInformation_GetCategoryDesc            4 sptr,int,sptr
#comfunc global ICatInformation_EnumClassesOfCategories    5 int,sptr,int,sptr,sptr
#comfunc global ICatInformation_IsClassOfCategories        6 sptr,int,sptr,int,sptr
#comfunc global ICatInformation_EnumImplCategoriesOfClass  7 sptr,sptr
#comfunc global ICatInformation_EnumReqCategoriesOfClass   8 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。