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

Статья
08/22/2023

[Функция 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 , который получает подписанный БОЛЬШОЙ двоичный объект. Завершив использование этой структуры, необходимо освободить память, передав этот указатель на функцию CryptUIWizFreeDigitalSignContext . Этот параметр может иметь значение NULL , если подписанный BLOB-объект не требуется.

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

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

Если функция завершается сбоем, она возвращает ноль.

Требования

Требование	Значение
Минимальная версия клиента	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