(msopc.h) IOpcSigningOptions 介面

發行項
08/25/2023

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

繼承

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