Поделиться через


Метод IXpsSignatureRequest::GetRequestId (xpsdigitalsignature.h)

Возвращает уникальный идентификатор запроса подписи.

Синтаксис

HRESULT GetRequestId(
  [out, retval] LPWSTR *requestId
);

Параметры

[out, retval] requestId

Уникальный идентификатор запроса подписи.

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.
E_POINTER
requestId имеет значение NULL.
E_UNEXPECTED
Интерфейс не подключен к диспетчеру подписей.

Комментарии

Этот метод выделяет память, используемую строкой, возвращаемой в requestId. Если аргумент requestId не равен NULL, используйте функцию CoTaskMemFree , чтобы освободить память.

Параметр requestId получает значение атрибута SpotID элемента SignatureDefinition . Атрибут SpotID является обязательным и должен соответствовать формату xs:ID (XML ID); однако существующие части SignatureDefinitions не проверяются на соответствие рекомендуемму формату. Некоторые документы XPS, созданные приложениями Windows Presentation Foundation (WPF), могут иметь идентификатор, начинающийся с цифры.

Требования

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

См. также раздел

IXpsSignatureManager

IXpsSignatureRequest

XPS

Ошибки API цифровой подписи XPS

Ошибки документа XPS