(msopc.h) IOpcSigningOptions 介面

提供方法來設定和存取產生簽章所需的資訊。

繼承

IOpcSigningOptions介面繼承自IUnknown介面。 IOpcSigningOptions 也有下列類型的成員:

方法

IOpcSigningOptions介面具有這些方法。

 
IOpcSigningOptions::GetCertificateEmbeddingOption

取得值,這個值會指定要用於簽章之憑證封裝中的儲存位置。
IOpcSigningOptions::GetCertificateSet

取得 IOpcCertificateSet 介面指標。
IOpcSigningOptions::GetCustomObjectSet

取得 IOpcSignatureCustomObjectSet 介面。
IOpcSigningOptions::GetCustomReferenceSet

取得 IOpcSignatureReferenceSet 介面指標。
IOpcSigningOptions::GetDefaultDigestMethod

取得預設摘要方法,這個方法將用來計算要簽署之物件的摘要值。
IOpcSigningOptions::GetSignatureId

從 Signature 元素取得 Id 屬性的值。
IOpcSigningOptions::GetSignatureMethod

取得簽章方法,用來計算和加密 SignedInfo 專案的雜湊值,此雜湊值會序列化為簽章的 SignatureValue 元素。
IOpcSigningOptions::GetSignaturePartName

取得要儲存簽章標記之簽章元件的元件名稱。
IOpcSigningOptions::GetSignaturePartReferenceSet

取得 IOpcSignaturePartReferenceSet 介面。
IOpcSigningOptions::GetSignatureRelationshipReferenceSet

取得 IOpcSignatureRelationshipReferenceSet 介面指標。
IOpcSigningOptions::GetTimeFormat

取得 IOpcDigitalSignature::GetSigningTime 方法所擷取的字串格式。
IOpcSigningOptions::SetCertificateEmbeddingOption

設定要用於簽章之憑證的儲存位置。
IOpcSigningOptions::SetDefaultDigestMethod

設定預設摘要方法,用來計算要簽署之物件的摘要值。
IOpcSigningOptions::SetSignatureId

設定 Signature 元素的 Id 屬性值。 (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions::SetSignatureMethod

設定簽章方法,以用來計算和加密 SignedInfo 元素的雜湊值,此雜湊值會包含在簽章的 SignatureValue 元素中。
IOpcSigningOptions::SetSignaturePartName

設定要儲存簽章標記之簽章元件的元件名稱。
IOpcSigningOptions::SetTimeFormat

設定 IOpcDigitalSignature::GetSigningTime 方法所擷取的字串格式。

備註

若要產生簽章,請呼叫 IOpcDigitalSignatureManager::Sign 方法,並將 signOptions 參數值設定為 IOpcSigningOptions 介面指標。

若要建立 IOpcSigningOptions 介面指標,請呼叫 IOpcDigitalSignatureManager::CreateSigningOptions 方法。

呼叫端必須先為摘要方法和簽章方法設定預設值,才能產生簽章。 若要設定預設摘要方法,請呼叫 SetDefaultDigestMethod 方法。 若要設定簽章方法,請呼叫 SetSignatureMethod 方法。

若要取得 IOpcSignatureCustomObjectSet 介面指標,請呼叫 GetCustomObjectSet 方法。 集合中的介面指標代表應用程式特定的 Object 元素。

若要取得 IOpcSignatureReferenceSet 介面指標,請呼叫 GetCustomReferenceSet 方法。 集合中的介面指標代表應用程式特定 Object 元素的參考,或產生簽章時將簽署的子系。

憑證的預設位置為 OPC_CERTIFICATE_IN_CERTIFICATE_PART。 若要變更此值,請呼叫 SetCertificateEmbeddingOption 方法。

簽署時間字串的預設格式 為 OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS。 若要變更簽署時間字串的格式,請呼叫 SetTimeFormat 方法。

執行緒安全性

封裝物件不是安全線程。

如需詳細資訊,請參閱使用封裝 API 消費者入門

需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msopc.h

另請參閱

核心封裝介面

數位簽章概觀

使用封裝 API 消費者入門

IOpcDigitalSignature

IOpcDigitalSignatureManager

概觀

封裝 API 程式設計指南

封裝 API 參考

封裝 API 範例

封裝數位簽章介面

封裝介面

參考