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

IAppxBlockMapFile

COM
📘 Microsoft Learn (日本語) · English
IID277672ac-4f63-42c1-8abc-beae3600eb59継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ブロックマップ内のファイルを表します。

解説(Remarks)

IAppxBlockMapFile インターフェースは、ブロックマップ内のファイルを表す読み取り専用のオブジェクトモデルを提供します。ファイルはブロックマップファイル内で File 要素によって表されます。File 要素からファイルの属性とブロックハッシュを取得できます。ブロックハッシュは IAppxBlockMapBlock インターフェースから取得できます。

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

メソッド 5

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

vtbl 3 HRESULT GetBlocks(IAppxBlockMapBlocksEnumerator** blocks)

ブロックマップに列挙されているファイルのブロックを走査するための列挙子を取得します。

blocksIAppxBlockMapBlocksEnumerator**outブロックを走査するための列挙子。

戻り値

型: HRESULT

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

vtbl 4 HRESULT GetLocalFileHeaderSize(DWORD* lfhSize)

関連付けられた zip ファイル項目の zip ローカルファイルヘッダーのサイズを取得します。

lfhSizeDWORD*out有効なアプリパッケージでは、lfhSize は関連付けられた zip ファイル項目の zip ローカルファイルヘッダーのサイズに対応します。

戻り値

型: HRESULT

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

vtbl 5 HRESULT GetName(LPWSTR* name)

関連付けられた zip ファイル項目の名前を取得します。

nameLPWSTR*out有効なアプリパッケージでは、name は関連付けられた zip ファイル項目の名前に対応します。

戻り値

型: HRESULT

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

解説(Remarks)

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

vtbl 6 HRESULT GetUncompressedSize(ULONGLONG* size)

関連付けられた zip ファイル項目の非圧縮サイズを取得します。

sizeULONGLONG*out 有効なアプリパッケージでは、size は関連付けられた zip ファイル項目の非圧縮サイズです。

戻り値

型: HRESULT

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

vtbl 7 HRESULT ValidateFileHash(IStream* fileStream, BOOL* isValid)

このブロックマップファイルの block 要素に格納されているハッシュと照合して、ファイルの内容を検証します。

fileStreamIStream*inファイルの内容を格納するストリーム。このストリームは Read、Seek、Stat をサポートしている必要があります。これらのメソッドが失敗した場合、そのエラーコードがこのメソッドに渡され、返されることがあります。
isValidBOOL*outファイルハッシュの検証に成功した場合は TRUE、それ以外の場合は FALSE。

戻り値

型: HRESULT

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAppxBlockMapFile "{277672AC-4F63-42C1-8ABC-BEAE3600EB59}"
#usecom global IAppxBlockMapFile IID_IAppxBlockMapFile "{}"
#comfunc global IAppxBlockMapFile_GetBlocks               3 sptr
#comfunc global IAppxBlockMapFile_GetLocalFileHeaderSize  4 var
#comfunc global IAppxBlockMapFile_GetName                 5 var
#comfunc global IAppxBlockMapFile_GetUncompressedSize     6 var
#comfunc global IAppxBlockMapFile_ValidateFileHash        7 sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。