Интерфейс IOpcSigningOptions (msopc.h)

Статья
08/25/2023

Предоставляет методы для задания и доступа к информации, необходимой для создания подписи.

Наследование

Интерфейс IOpcSigningOptions наследуется от интерфейса IUnknown . IOpcSigningOptions также имеет следующие типы элементов:

Методы

Интерфейс IOpcSigningOptions содержит следующие методы.


IOpcSigningOptions::GetCertificateEmbeddingOption Возвращает значение, указывающее расположение хранилища в пакете сертификата, используемого для подписи.
IOpcSigningOptions::GetCertificateSet Возвращает указатель интерфейса IOpcCertificateSet.
IOpcSigningOptions::GetCustomObjectSet Возвращает интерфейс IOpcSignatureCustomObjectSet.
IOpcSigningOptions::GetCustomReferenceSet Возвращает указатель интерфейса IOpcSignatureReferenceSet.
IOpcSigningOptions::GetDefaultDigestMethod Возвращает метод дайджеста по умолчанию, который будет использоваться для вычисления значений дайджеста для подписываемых объектов.
IOpcSigningOptions::GetSignatureId Возвращает значение атрибута Id из элемента Signature.
IOpcSigningOptions::GetSignatureMethod Возвращает метод подписи, используемый для вычисления и шифрования хэш-значения элемента SignedInfo, который будет сериализован как элемент SignatureValue подписи.
IOpcSigningOptions::GetSignaturePartName Возвращает имя части сигнатуры, в которой будет храниться разметка подписи.
IOpcSigningOptions::GetSignaturePartReferenceSet Возвращает интерфейс IOpcSignaturePartReferenceSet.
IOpcSigningOptions::GetSignatureRelationshipReferenceSet Возвращает указатель интерфейса IOpcSignatureRelationshipReferenceSet.
IOpcSigningOptions::GetTimeFormat Возвращает формат строки, полученной методом IOpcDigitalSignature::GetSigningTime.
IOpcSigningOptions::SetCertificateEmbeddingOption Задайте место хранения сертификата, которое будет использоваться для подписи.
IOpcSigningOptions::SetDefaultDigestMethod Задает метод дайджеста по умолчанию, который будет использоваться для вычисления значений дайджеста для подписываемых объектов.
IOpcSigningOptions::SetSignatureId Задает значение атрибута Id элемента Signature. (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions::SetSignatureMethod Задает метод подписи, используемый для вычисления и шифрования хэш-значения элемента SignedInfo, который будет содержаться в элементе SignatureValue подписи.
IOpcSigningOptions::SetSignaturePartName Задает имя части сигнатуры, в которой будет храниться разметка подписи.
IOpcSigningOptions::SetTimeFormat Задает формат строки, полученной методом IOpcDigitalSignature::GetSigningTime.

Перед созданием сигнатуры вызывающий объект должен задать значение по умолчанию для метода дайджеста и метода сигнатуры. Чтобы задать метод дайджеста по умолчанию, вызовите метод 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
Header	msopc.h