IAppxManifestProperties
COM公式ドキュメント
パッケージマニフェストの properties セクションへの読み取り専用アクセスを提供します。
解説(Remarks)
マニフェストの properties セクションは、Properties 要素を使用して定義します。
このオブジェクトは、IAppxManifestReader::GetProperties メソッドを使用して取得できます。
例
例については、クイックスタート: アプリパッケージのマニフェスト情報を読み取るを参照してください。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
properties セクション内の指定した Boolean 要素の値を取得します。
| name | LPWSTR | in | Boolean 要素の名前。有効な値は次のとおりです。 "Framework" "ResourcePackage" (Windows 8.1 以降) |
| value | BOOL* | out | 指定した Boolean 要素の値。 |
戻り値
型: HRESULT
このメソッドが成功すると、S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
この名前を持つ有効な Boolean プロパティがマニフェストに定義されていない場合、このメソッドは E_INVALIDARG を返し、value は FALSE になります。
properties セクション内の指定した文字列要素の値を取得します。
| name | LPWSTR | in | 文字列要素の名前。有効な値は次のとおりです。 "Description" "DisplayName" "Logo" "PublisherDisplayName" |
| value | LPWSTR* | out | 指定した要素の値。 |
戻り値
型: HRESULT
このメソッドが成功すると、S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
この名前を持つ有効な文字列プロパティがマニフェストに定義されていない場合、このメソッドは E_INVALIDARG を返し、value には null 文字列が格納されます。
呼び出し元は、value に割り当てられたメモリを CoTaskMemFree 関数を使用して解放する必要があります。
例
例については、クイックスタート: アプリパッケージのマニフェスト情報を読み取るを参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IAppxManifestProperties "{03FAF64D-F26F-4B2C-AAF7-8FE7789B8BCA}" #usecom global IAppxManifestProperties IID_IAppxManifestProperties "{}" #comfunc global IAppxManifestProperties_GetBoolValue 3 wstr,var #comfunc global IAppxManifestProperties_GetStringValue 4 wstr,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IAppxManifestProperties "{03FAF64D-F26F-4B2C-AAF7-8FE7789B8BCA}" #usecom global IAppxManifestProperties IID_IAppxManifestProperties "{}" #comfunc global IAppxManifestProperties_GetBoolValue 3 wstr,sptr #comfunc global IAppxManifestProperties_GetStringValue 4 wstr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。