Метод IOpcSignaturePartReferenceSet::Create (msopc.h)

Статья
08/25/2023

Создает указатель интерфейса IOpcSignaturePartReference , который представляет ссылку на часть, которую нужно подписать, и добавляет новый интерфейс в набор.

Синтаксис

HRESULT Create(
  [in]          IOpcPartUri                 *partUri,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignaturePartReference  **partReference
);

Параметры

[in] partUri

IOpcPartUri, представляющий имя части, на которую следует ссылаться.

[in] digestMethod

Метод дайджеста, используемый для части содержимого части, на которую следует ссылаться. Чтобы использовать метод дайджеста по умолчанию, передайте этому параметру значение NULL .

Важно Метод дайджеста по умолчанию необходимо задать путем вызова метода IOpcSigningOptions::SetDefaultDigestMethod перед вызовом метода IOpcDigitalSignatureManager::Sign .

[in] transformMethod

Метод канонизации, используемый для части содержимого части, на которую следует ссылаться.

[out, retval] partReference

Новый указатель интерфейса IOpcSignaturePartReference , представляющий ссылку на подписываемую часть.

Этот параметр может иметь значение NULL , если указатель на новый интерфейс не требуется.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Значение, передаваемое в параметре transformMethod , не является допустимым значением перечисления OPC_CANONICALIZATION_METHOD.
E_POINTER	Параметр partUri имеет значение NULL.

Указатель интерфейса IOpcSignaturePartReference может ссылаться только на части, которые могут быть представлены интерфейсом IOpcSignaturePartReference. На части связей ссылается для подписывания указатель на интерфейс IOpcSignatureRelationshipReference . Чтобы создать указатель интерфейса IOpcSignatureRelationshipReference , вызовите метод IOpcSignatureRelationshipReferenceSet::Create .

Когда создается указатель интерфейса IOpcSignaturePartReference и добавляется в набор, ссылка, которую он представляет, сохраняется при сохранении пакета.

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в начало работы с API упаковки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h