Метод IXpsSignatureRequest::GetRequestId (xpsdigitalsignature.h)
Возвращает уникальный идентификатор запроса подписи.
Синтаксис
HRESULT GetRequestId(
[out, retval] LPWSTR *requestId
);
Параметры
[out, retval] requestId
Уникальный идентификатор запроса подписи.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Возвращаемые значения, не перечисленные в этой таблице, см. в разделах Ошибки API цифровой подписи XPS и Ошибки документа XPS.
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
requestId имеет значение NULL. |
|
Интерфейс не подключен к диспетчеру подписей. |
Комментарии
Этот метод выделяет память, используемую строкой, возвращаемой в 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 |