IXpsSignatureBlock：：CreateRequest 方法 (xpsdigitalsignature.h)

建立新的 IXpsSignatureRequest 介面，並將它新增至簽章區塊。

語法

HRESULT CreateRequest(
  [in]          LPCWSTR              requestId,
  [out, retval] IXpsSignatureRequest **signatureRequest
);

[in] requestId

可唯一識別簽章區塊內新簽章要求的字串。若要讓方法產生識別碼字串，請將此參數設定為 Null。

[out, retval] signatureRequest

新 IXpsSignatureRequest 介面的指標。如果不需要存取新的要求介面，則可以將此參數設定為 Null。

方法會傳回 HRESULT。可能的值包括下列資料表中的值，但不限於這些值。如需此表格中未列出的傳回值，請參閱 XPS 數位簽章 API 錯誤和 XPS 檔錯誤。

傳回碼	描述
S_OK	此方法已成功。
E_UNEXPECTED	介面未連線到簽章管理員，或 requestId 為 Null ，而且無法產生唯一識別碼字串。

新的簽章要求必須有唯一的要求識別碼;沒有兩個要求可能具有相同的識別碼字串。

建立新的要求會將簽章區塊標示為 已變更 ，並產生 SignatureDefinitions 元件的新內容。序列化 XPS 套件時，新內容將會覆寫 SignatureDefinitions 元件中的先前內容。