ホーム › System.UpdateAgent › ICategory

ICategory

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID81ddc1b8-9d35-47a6-b471-5b80f519223b継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

更新プログラムが属するカテゴリを表します。

メソッド 9

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Name(LPWSTR* retval)

カテゴリのローカライズされた名前を取得します。

retval

LPWSTR*

out

カテゴリの名前を受け取る文字列ポインタへのポインタである。

解説(Remarks)

IUpdate インターフェイスには Categories プロパティが存在します。また、IUpdateHistoryEntry2 インターフェイスにも Categories プロパティが存在します。したがって、ICategory インターフェイスのローカライズされたプロパティが使用する情報は、その ICategory インターフェイスを所有する Windows Update Agent (WUA) オブジェクトによって異なります。

ICategory インターフェイスが IUpdate の Categories プロパティから返される場合、ICategory インターフェイスは IUpdate インターフェイスのローカライズ規則に従います。この場合、IUpdateSearcher インターフェイスが IUpdateSession::CreateUpdateSearcher メソッドを使用して作成されていれば、このプロパティが返す情報は、IUpdateSearcher の作成に使用したセッションの IUpdateSession2 インターフェイスの UserLocale プロパティで指定された言語のものになります。

IUpdateSession2 インターフェイスの UserLocale プロパティで言語の優先設定が指定されていない場合、または IUpdateSearcher インターフェイスが IUpdateSession::CreateUpdateSearcher メソッドを使用して作成されていない場合、このプロパティが返す情報は、ユーザーの既定のユーザーインターフェイス (UI) 言語のものになります。ユーザーの既定の UI 言語が利用できない場合、WUA はコンピューターの既定の UI 言語を使用します。コンピューターの既定の言語が利用できない場合、WUA は更新プログラムの提供元が推奨する言語を使用します。

ICategory インターフェイスが IUpdateHistoryEntry2 インターフェイスの Categories プロパティから返される場合、ICategory インターフェイスは IUpdateHistoryEntry2 インターフェイスのローカライズ規則に従います。このプロパティが返す情報は、ユーザーの既定の UI 言語のものになります。ユーザーの既定の UI 言語が利用できない場合、WUA はコンピューターの既定の UI 言語を使用します。コンピューターの既定の言語が利用できない場合、WUA は更新プログラムの提供元が推奨する言語を使用します。

vtbl 8 HRESULT get_CategoryID(LPWSTR* retval)

カテゴリの識別子を取得します。

retval

LPWSTR*

out

カテゴリの一意な識別子 (GUID 文字列) を受け取る文字列ポインタへのポインタである。

vtbl 9 HRESULT get_Children(ICategoryCollection** retval)

このカテゴリの子カテゴリを含むインターフェイスのコレクションを取得します。

retval

ICategoryCollection**

out

子カテゴリのコレクションを表す ICategoryCollection インターフェイスを受け取るポインタへのポインタである。

vtbl 10 HRESULT get_Description(LPWSTR* retval)

カテゴリの説明を取得します。

retval

LPWSTR*

out

カテゴリの説明文を受け取る文字列ポインタへのポインタである。

解説(Remarks)

vtbl 11 HRESULT get_Image(IImageInformation** retval)

カテゴリに関連付けられている画像に関する情報を含むインターフェイスを取得します。

retval

IImageInformation**

out

カテゴリに関連付けられた画像情報を表す IImageInformation インターフェイスを受け取るポインタへのポインタである。画像がない場合は NULL が返る。

解説(Remarks)

vtbl 12 HRESULT get_Order(INT* retval)

兄弟カテゴリの中における、このカテゴリの推奨表示順序を取得します。

retval

INT*

out

カテゴリの表示順序を表す値を受け取る出力先へのポインタである。

vtbl 13 HRESULT get_Parent(ICategory** retval)

このカテゴリの親カテゴリを表すインターフェイスを取得します。

retval

ICategory**

out

親カテゴリを表す ICategory インターフェイスを受け取るポインタへのポインタである。親がない場合は NULL が返る。

vtbl 14 HRESULT get_Type(LPWSTR* retval)

カテゴリの種類を取得します。

retval

LPWSTR*

out

カテゴリの種類を表す文字列を受け取る文字列ポインタへのポインタである。

解説(Remarks)

次の一覧は、指定できるカテゴリの種類を示しています:

vtbl 15 HRESULT get_Updates(IUpdateCollection** retval)

そのカテゴリに直接属する更新プログラムのコレクションを含むインターフェイスを取得します。

retval

IUpdateCollection**

out

このカテゴリに属する更新のコレクションを表す IUpdateCollection インターフェイスを受け取るポインタへのポインタである。

解説(Remarks)

返される更新プログラムは、そのコンピューターに適用可能なものです。ただし、そのコンピューターにインストールされている場合もあれば、されていない場合もあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ICategory "{81DDC1B8-9D35-47A6-B471-5B80F519223B}"
#usecom global ICategory IID_ICategory "{}"
#comfunc global ICategory_get_Name         7 var
#comfunc global ICategory_get_CategoryID   8 var
#comfunc global ICategory_get_Children     9 sptr
#comfunc global ICategory_get_Description  10 var
#comfunc global ICategory_get_Image        11 sptr
#comfunc global ICategory_get_Order        12 var
#comfunc global ICategory_get_Parent       13 sptr
#comfunc global ICategory_get_Type         14 var
#comfunc global ICategory_get_Updates      15 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ICategory "{81DDC1B8-9D35-47A6-B471-5B80F519223B}"
#usecom global ICategory IID_ICategory "{}"
#comfunc global ICategory_get_Name         7 sptr
#comfunc global ICategory_get_CategoryID   8 sptr
#comfunc global ICategory_get_Children     9 sptr
#comfunc global ICategory_get_Description  10 sptr
#comfunc global ICategory_get_Image        11 sptr
#comfunc global ICategory_get_Order        12 sptr
#comfunc global ICategory_get_Parent       13 sptr
#comfunc global ICategory_get_Type         14 sptr
#comfunc global ICategory_get_Updates      15 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。