Метод IXpsSignatureBlock::CreateRequest (xpsdigitalsignature.h)
Создает интерфейс IXpsSignatureRequest и добавляет его в блок подписи.
Синтаксис
HRESULT CreateRequest(
[in] LPCWSTR requestId,
[out, retval] IXpsSignatureRequest **signatureRequest
);
Параметры
[in] requestId
Строка, однозначно идентифицирующая новый запрос подписи в блоке подписи. Чтобы метод создал строку идентификатора, присвойте этому параметру значение NULL.
[out, retval] signatureRequest
Указатель на новый интерфейс IXpsSignatureRequest . Если доступ к новому интерфейсу запроса не требуется, для этого параметра можно задать значение NULL.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Возвращаемые значения, не перечисленные в этой таблице, см. в разделах Ошибки API цифровой подписи XPS и Ошибки документа XPS.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Либо интерфейс не подключен к диспетчеру подписей, либо аргумент requestId имеет значение NULL , и не удалось создать строку уникального идентификатора. |
Комментарии
Новый запрос подписи должен иметь уникальный идентификатор запроса; ни один запрос не может иметь одну и ту же строку идентификатора.
При создании запроса блок подписи помечается как грязное и создается новое содержимое для части SignatureDefinitions. При сериализации пакета XPS новое содержимое перезапишет предыдущее содержимое в части SignatureDefinitions.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | xpsdigitalsignature.h |