Win32 API 日本語リファレンス
ホーム › Storage.Packaging.Appx › IAppxBlockMapBlock

IAppxBlockMapBlock

COM
📘 Microsoft Learn (日本語) · English
IID75cf3930-3244-4fe0-a8c8-e0bcb270b889継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IAppxBlockMapBlock インターフェイスは、アプリパッケージのブロックマップファイル (AppxBlockMap.xml) に含まれるファイル内の個々のブロックを表す、読み取り専用のオブジェクトを提供します。

解説(Remarks)

各 Block 要素は、そのブロックのハッシュ値と圧縮後のサイズを表す属性を持ちます。

コード例については、Query app package and app manifest sample を参照してください。

メソッド 2

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

vtbl 3 HRESULT GetHash(DWORD* bufferSize, BYTE** buffer)

ブロックのハッシュ値を取得します。

bufferSizeDWORD*outbuffer の長さです。
bufferBYTE**outブロックのハッシュ値を表すバイト列です。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

buffer の値は、Block 要素の Hash 属性に対応します。

buffer に使用されたメモリの解放は呼び出し元の責任です。メモリの解放には CoTaskMemFree 関数を使用してください。

vtbl 4 HRESULT GetCompressedSize(DWORD* size)

ブロックの圧縮後のサイズを取得します。

sizeDWORD*outブロックの圧縮後のサイズ (バイト単位) です。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このサイズは、ブロックの圧縮後のサイズに対応します。

size の値は、ブロックマップ内の Block 要素の Size 属性に対応します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAppxBlockMapBlock "{75CF3930-3244-4FE0-A8C8-E0BCB270B889}"
#usecom global IAppxBlockMapBlock IID_IAppxBlockMapBlock "{}"
#comfunc global IAppxBlockMapBlock_GetHash            3 var,var
#comfunc global IAppxBlockMapBlock_GetCompressedSize  4 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。