Метод ICertSrvSetup::CAImportPFX (casetup.h)

Статья
03/14/2023

Метод CAImportPFX импортирует сертификат центра сертификации (ЦС) и связанный с ним закрытый ключ в хранилище локального компьютера. Этот метод не изменяет состояние объекта CCertSrvSetup .

Синтаксис

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

Параметры

[in] bstrFileName

Строка, содержащая имя PFX-файла, используемого для импорта закрытого ключа.

[in] bstrPasswd

Строка, содержащая пароль для PFX-файла.

[in] bOverwriteExistingKey

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

[out] ppVal

Адрес указателя на интерфейс ICertSrvSetupKeyInformation , который можно использовать для задания свойств импортированного закрытого ключа.

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

None

Remarks

Метод CAImportPFX использует входные параметры для расшифровки и декодирования PFX-файла, а затем устанавливает ключ и сертификат в хранилище локального компьютера. Если сертификат удовлетворяет следующим критериям и после установки ключа метод возвращает объект ICertSrvSetupKeyInformation вызывающей объект.

Содержит ключ AT_SIGNATURE, соответствующий ключу в контейнере закрытого ключа.
Является самозаверяющим или имеет основные ограничения для ЦС.
Проходит проверку цепочки, но может возникать ошибка отзыва в автономном режиме.

Если PFX-файл содержит несколько сертификатов и ключей, CAImportPFX устанавливает все сертификаты и ключи; однако возвращенный объект ICertSrvSetupKeyInformation содержит только свойства последнего сертификата ЦС в файле. Когда вызывающий объект завершает работу с объектом ICertSrvSetupKeyInformation , вызывающий объект должен освободить его с помощью метода Release .

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	casetup.h
DLL	Certocm.dll

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

ICertSrvSetup

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