共用方式為

IAppxFactory3：：CreateManifestReader2 方法 (appxpackaging.h)

  • 發行項

重要

某些資訊與發行前版本產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從 IStream 提供的內容建立唯讀指令清單物件模型，並提供選擇性參數來指定指令清單的預期摘要。

語法

HRESULT CreateManifestReader2(
  [in]          IStream             *inputStream,
  [in,optional] LPCWSTR             expectedDigest,
  [out]         IAppxManifestReader **manifestReader
);

參數

[in] inputStream

傳遞指令清單 XML 以供讀取的輸入數據流。 數據流必須支援 ISequentialStream：：Read、 IStream：：Seek 和 IStream：：Stat。如果這些方法失敗，其錯誤碼可能會傳遞至此方法，並由此方法傳回。

[in,optional] expectedDigest

包含預期摘要的 LPCWSTR，這是指令清單檔案的哈希表示法。

[out] manifestReader

建立的指令清單讀取器。

傳回值

如果方法成功，則會傳回 S_OK。 否則，它會傳回錯誤碼，其中包含下表中的錯誤碼，但不限於這些錯誤碼。

傳回碼 Description
APPX_E_INVALID_MANIFEST inputStream 不包含指令清單的語法有效 XML。
APPX_E_DIGEST_MISMATCH 對象的摘要與 expectedDigest 中提供的摘要不符。

備註

使用 CreateManifestReader2 讀取應用程式套件外部的指令清單。 這個方法會驗證指令清單 XML。 manifestReader 可讓您存取指令清單 XML 中的所有數據元素和屬性。 指令清單會記錄 AppxPackaging 之 ETW 事件記錄檔中指令清單驗證錯誤的位置。

呼叫 IAppxDigestProvider：：GetDigest 來取得 expecteDigest 參數的摘要字串。

範例

如需範例，請參閱 快速入門：讀取應用程式套件指令清單資訊。

規格需求

需求 值
標頭 appxpackaging.h