Функция CryptUIWizDigitalSign (cryptuiapi.h)
[Функция 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_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 |