Метод IXpsSignatureManager::AddSignatureBlock (xpsdigitalsignature.h)

Статья
03/13/2024

Создает интерфейс IXpsSignatureBlock и добавляет его в коллекцию блоков подписи.

Синтаксис

HRESULT AddSignatureBlock(
  [in]          IOpcPartUri        *partName,
  [in]          UINT32             fixedDocumentIndex,
  [out, retval] IXpsSignatureBlock **signatureBlock
);

Параметры

[in] partName

Указатель на интерфейс IOpcPartUri , содержащий универсальный код ресурса (URI) новой части. Чтобы метод создал имя части, этот параметр может иметь значение NULL.

[in] fixedDocumentIndex

Значение индекса части FixedDocument, с которой должен быть связан новый блок подписи.

[out, retval] signatureBlock

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

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

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Возвращаемые значения, не перечисленные в этой таблице, см. в разделах Ошибки API цифровой подписи XPS и Ошибки документов XPS.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	fixedDocumentIndex ссылается на фиксированный документ, который не найден в пакете XPS.
XPS_E_PACKAGE_NOT_OPENED	Пакет XPS еще не открыт в диспетчере подписей.

Блок подписи представляет часть SignatureDefinitions в пакете XPS. В соответствии с разделом 10.2.2 в спецификации XML-документа к каждому объекту FixedDocument можно присоединить ноль или более частей SignatureDefinitions. Этот метод создает новую часть SignatureDefinitions с указанным именем, связывает ее с указанной частью FixedDocument связью, создает интерфейс IXpsSignatureBlock и добавляет этот новый интерфейс во внутреннюю коллекцию блоков подписи.

Чтобы получить блок подписи, вызовите метод GetSignatureBlocks .

Требования

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