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

Статья
08/22/2023

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

Структура CRYPTUI_WIZ_IMPORT_SRC_INFO содержит субъект для импорта в функцию CryptUIWizImport . Субъектом может быть сертификат, список доверия сертификатов (CTL) или список отзыва сертификатов (CRL).

Синтаксис

typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO {
  DWORD   dwSize;
  DWORD   dwSubjectChoice;
  union {
    LPCWSTR        pwszFileName;
    PCCERT_CONTEXT pCertContext;
    PCCTL_CONTEXT  pCTLContext;
    PCCRL_CONTEXT  pCRLContext;
    HCERTSTORE     hCertStore;
  };
  DWORD   dwFlags;
  LPCWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;

Члены

dwSize

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

dwSubjectChoice

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

Значение	Значение
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE	Импортируйте сертификат, хранящийся в файле, на который ссылается элемент pwszFileName .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT	Импортируйте сертификат, указанный в элементе pCertContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT	Импортируйте CTL, указанный в элементе pCTLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT	Импортируйте список отзыва сертификатов, указанный в элементе pCRLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE	Импортируйте хранилище сертификатов, указанное в элементе hCertStore .

pwszFileName

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

pCertContext

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

pCTLContext

Указатель на структуру CTL_CONTEXT , содержащую импортируемый CTL. Этот элемент используется, если элемент dwSubjectChoice содержит CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT.

pCRLContext

Указатель на структуру CRL_CONTEXT , содержащую список отзыва сертификатов для импорта. Этот элемент используется, если элемент dwSubjectChoice содержит CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT.

hCertStore

Дескриптор хранилища сертификатов для импорта. Этот элемент используется, если элемент dwSubjectChoice содержит CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE.

dwFlags

Содержит флаги, изменяющие операцию импорта. Этот член является обязательным, если pwszFileName содержит большой двоичный объект обмена личной информацией (PFX). В противном случае этот элемент игнорируется. Этот элемент может быть нулевым или сочетанием одного или нескольких из следующих значений.

Значение	Значение
CRYPT_EXPORTABLE	Импортированные ключи помечаются как доступные для экспорта. Если этот флаг не используется, вызовы функции CryptExportKey с дескриптором ключа завершаются ошибкой.
CRYPT_USER_PROTECTED	Пользователь должен получать уведомление с помощью диалогового окна или каким-либо другим способом, когда определенные действия пытаются использовать этот ключ. Точное поведение определяется используемым поставщиком служб шифрования (CSP). До internet Обозреватель 4.0 поставщики служб конфигурации Майкрософт игнорируют этот флаг. Начиная с Internet Обозреватель 4.0, поставщики служб конфигурации Майкрософт поддерживают этот флаг. Если контекст поставщика был открыт с установленным флагом CRYPT_SILENT , использование этого флага приведет к сбою, а для последней ошибки задано значение NTE_SILENT_CONTEXT.
CRYPT_MACHINE_KEYSET	Закрытые ключи хранятся на локальном компьютере, а не под текущим пользователем.
CRYPT_USER_KEYSET	Закрытые ключи хранятся под текущим пользователем, а не на локальном компьютере, даже если большой двоичный объект PFX указывает, что они должны находиться под локальным компьютером.

pwszPassword

Указатель на строку Юникода, завершающуюся null, которая содержит пароль, используемый для доступа к закрытому ключу. Пароль требуется, если pwszFileName содержит большой двоичный объект PFX. Если пароль не требуется, переменная может быть пустой строкой. Этот элемент не может иметь значение NULL.

Требования


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

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

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport

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