IAppxManifestPackageDependenciesEnumerator
COM公式ドキュメント
パッケージマニフェストで定義されたパッケージ依存関係を列挙します。
解説(Remarks)
このオブジェクトは IAppxManifestReader::GetPackageDependencies メソッドを使用して取得できます。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
列挙子の現在位置にある依存パッケージを取得します。
| dependency | IAppxManifestPackageDependency** | out | 現在の依存パッケージです。 |
戻り値
型: HRESULT
メソッドが成功した場合は S_OK を返します。それ以外の場合は、次の表に示すものを含む(ただしこれらに限定されない)エラーコードを返します。
| 戻り値 | 説明 |
|---|---|
| 列挙子がコレクションの最後の項目を超えて進んでいます。 |
解説(Remarks)
返される列挙子は空の場合があります。その場合、GetHasCurrent の呼び出しは false を返します。列挙子が空でない場合は最初の要素を指しており、このメソッドは最初の項目を返します。以降、ユーザーは MoveNext を使用して項目間を移動し、項目にアクセスするために GetCurrent を使用する前に GetHasCurrent を呼び出す必要があります。
列挙子の現在位置にパッケージ依存関係が存在するかどうかを判定します。
| hasCurrent | BOOL* | out | 列挙子の現在位置が項目を参照している場合は TRUE、列挙子がコレクションの最後の項目を超えて進んでいる場合は FALSE です。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
列挙子の位置を次のパッケージ依存関係へ進めます。
| hasNext | BOOL* | out | 列挙子が正常に進んだ場合は TRUE です。 列挙子がコレクションの末尾を超えて進んだ場合は FALSE です。 |
戻り値
型: HRESULT
メソッドが成功した場合は S_OK を返します。それ以外の場合はエラーコードを返します。
列挙子が初めてコレクションの末尾を超えたときは hasNext = FALSE となりますが、メソッドは成功し S_OK を返す点に注意してください。ただし、すでにコレクションの末尾を超えて hasNext = FALSE を受け取った後、さらに MoveNext を呼び出した場合、このメソッドは E_BOUNDS を返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IAppxManifestPackageDependenciesEnumerator "{B43BBCF9-65A6-42DD-BAC0-8C6741E7F5A4}" #usecom global IAppxManifestPackageDependenciesEnumerator IID_IAppxManifestPackageDependenciesEnumerator "{}" #comfunc global IAppxManifestPackageDependenciesEnumerator_GetCurrent 3 sptr #comfunc global IAppxManifestPackageDependenciesEnumerator_GetHasCurrent 4 var #comfunc global IAppxManifestPackageDependenciesEnumerator_MoveNext 5 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IAppxManifestPackageDependenciesEnumerator "{B43BBCF9-65A6-42DD-BAC0-8C6741E7F5A4}" #usecom global IAppxManifestPackageDependenciesEnumerator IID_IAppxManifestPackageDependenciesEnumerator "{}" #comfunc global IAppxManifestPackageDependenciesEnumerator_GetCurrent 3 sptr #comfunc global IAppxManifestPackageDependenciesEnumerator_GetHasCurrent 4 sptr #comfunc global IAppxManifestPackageDependenciesEnumerator_MoveNext 5 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。