Функция CryptUIWizDigitalSign (cryptuiapi.h)

Статья
05/30/2024

[Функция CryptUIWizDigitalSign доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция CryptUIWizDigitalSign цифровой подписывает документ или БОЛЬШОЙ ДВОИЧНЫй объект. Документ или большой двоичный объект можно подписать с помощью или без участия пользователя.

Синтаксис

BOOL CryptUIWizDigitalSign(
  [in]            DWORD                              dwFlags,
  [in, optional]  HWND                               hwndParent,
  [in, optional]  LPCWSTR                            pwszWizardTitle,
  [in]            PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO    pDigitalSignInfo,
  [out, optional] PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);

Параметры

[in] dwFlags

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

Значение	Значение
CRYPTUI_WIZ_NO_UI 0x0001	Эта функция подписывает документ на основе сведений в структуре CRYPTUI_WIZ_DIGITAL_SIGN_INFO , на которую указывает параметр pDigitalSignInfo , не отображая пользовательский интерфейс. Если этот флаг не указан, эта функция отобразит мастер, который поможет пользователю пройти процесс подписывания.

Значение

CRYPTUI_WIZ_NO_UI
0x0001

Эта функция подписывает документ на основе сведений в структуре CRYPTUI_WIZ_DIGITAL_SIGN_INFO , на которую указывает параметр pDigitalSignInfo , не отображая пользовательский интерфейс. Если этот флаг не указан, эта функция отобразит мастер, который поможет пользователю пройти процесс подписывания.

[in, optional] hwndParent

Дескриптор окна, используемого в качестве родительского элемента диалогового окна, создаваемого этой функцией. Этот параметр игнорируется, если флаг CRYPTUI_WIZ_NO_UI установлен в dwFlags.

[in, optional] pwszWizardTitle

Указатель на строку Юникода, завершающуюся null, которая содержит заголовок, используемый в диалоговом окне, создаваемом этой функцией. Этот параметр игнорируется, если флаг CRYPT_WIZ_NO_UI установлен в dwFlags. Если этот параметр имеет значение NULL, используется заголовок по умолчанию.

[in] pDigitalSignInfo

Указатель на структуру CRYPTUI_WIZ_DIGITAL_SIGN_INFO , содержащую сведения о процессе подписывания.

[out, optional] ppSignContext

Указатель на указатель структуры CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT , который получает подписанный BLOB-объект. Завершив использование этой структуры, необходимо освободить память, передав этот указатель на функцию CryptUIWizFreeDigitalSignContext . Если подписанный BLOB-объект не требуется, этот параметр может иметь значение NULL .

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

Если функция выполняется успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	cryptuiapi.h
Библиотека	Cryptui.lib
DLL	Cryptui.dll

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

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext

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