структура CRYPTUI_WIZ_DIGITAL_SIGN_INFO (cryptuiapi.h)

  • Статья

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

Структура CRYPTUI_WIZ_DIGITAL_SIGN_INFO содержит сведения о цифровой подписи. Эта структура используется функцией CryptUIWizDigitalSign .

Синтаксис

typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO {
  DWORD                                    dwSize;
  DWORD                                    dwSubjectChoice;
  union {
    LPCWSTR                              pwszFileName;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo;
  };
  DWORD                                    dwSigningCertChoice;
  union {
    PCCERT_CONTEXT                           pSigningCertContext;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO    pSigningCertStore;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo;
  };
  LPCWSTR                                  pwszTimestampURL;
  DWORD                                    dwAdditionalCertChoice;
  PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
} CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;

Члены

dwSize

Размер структуры (в байтах).

dwSubjectChoice

Значение типа , указывающее сущность, которая должна быть подписана. Этот член является обязательным, если CRYPTUI_WIZ_NO_UI указан в параметре dwFlags функции CryptUIWizDigitalSign . Это может быть одно из следующих значений.

Значение Значение
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB
 Большой двоичный объект памяти, указанный членом pSignBlobInfo , должен быть подписан.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE
 Файл, указанный членом pwszFileName , должен быть подписан.
0
 Пользователю будет предложено ввести файл для подписания.

pwszFileName

Указатель на строку Юникода с пустым завершением, которая содержит путь и имя файла для подписывания. Этот элемент используется, если для элемента dwSubjectChoice указано CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE.

pSignBlobInfo

Указатель на структуру CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO , содержащую большой двоичный объект для подписывания. Этот элемент используется, если для элемента dwSubjectChoice указано CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB.

dwSigningCertChoice

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

Примечание Если CRYPTUI_WIZ_NO_UI указан в параметре dwFlags функции CryptUIWizDigitalSign , это значение должно быть либо CRYPTUI_WIZ_DIGITAL_SIGN_CERT , либо CRYPTUI_WIZ_DIGITAL_SIGN_PVK.
 
Значение Значение
CRYPTUI_WIZ_DIGITAL_SIGN_CERT
 Сертификат содержится в структуре CERT_CONTEXT , на которую указывает элемент pSigningCertContext .
CRYPTUI_WIZ_DIGITAL_SIGN_STORE
 Сертификат содержится в хранилище сертификатов, содержащееся в структуре CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO , на которую указывает член pSigningCertStore .
CRYPTUI_WIZ_DIGITAL_SIGN_PVK
 Сертификат содержится в PVK-файле, который содержится в структуре CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO , на которую указывает элемент pSigningCertPvkInfo .
0
 Используются сертификаты в моем хранилище.

pSigningCertContext

Указатель на структуру CERT_CONTEXT , содержащую сертификат , используемый для подписи сущности. Этот элемент используется, если для элемента dwSigningCertChoice указано CRYPTUI_WIZ_DIGITAL_SIGN_CERT.

pSigningCertStore

Указатель на структуру CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO , содержащую сертификат, используемый для подписи сущности. Этот элемент используется, если для элемента dwSigningCertChoice указано CRYPTUI_WIZ_DIGITAL_SIGN_STORE.

pSigningCertPvkInfo

Указатель на структуру CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO , содержащую сертификат, используемый для подписи сущности. Этот элемент используется, если для элемента dwSigningCertChoice указано CRYPTUI_WIZ_DIGITAL_SIGN_PVK.

pwszTimestampURL

Указатель на строку Юникода, завершающуюся null, которая содержит URL-адрес метки времени.

dwAdditionalCertChoice

Значение типа , указывающее, будут ли в подписи включены дополнительные сертификаты. Значение по умолчанию равно нулю. Это может быть одно из следующих значений.

Значение Значение
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN
 В сигнатуру будет включена вся цепочка сертификатов.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT
 Все сертификаты в цепочке сертификатов, кроме корневого, будут включены в сигнатуру.
0
 Дополнительные сертификаты не будут включены в сигнатуру.

pSignExtInfo

Указатель на структуру CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO , содержащую расширенные сведения о сигнатуре.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть cryptuiapi.h

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

CryptUIWizDigitalSign