Метод ICertAdmin2::ImportKey (certadm.h)

Статья
08/22/2023

Метод ImportKey добавляет зашифрованный набор ключей в элемент в базе данных служб сертификатов. Набор ключей шифруется для одного или нескольких сертификатов агента восстановления ключей (KRA).

Синтаксис

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

Параметры

[in] strConfig

Строковое значение, представляющее допустимую строку конфигурации для центра сертификации (ЦС) в формате COMPUTERNAME\CANAME, где COMPUTERNAME — сетевое имя сервера служб сертификации, а CANAME — общее имя ЦС, указанное при настройке служб сертификации. Дополнительные сведения об имени строки конфигурации см. в разделе ICertConfig.

Важно!ImportKey не очищает внутренний кэш при изменении строки конфигурации. При изменении строки конфигурации для ЦС необходимо создать экземпляр нового объекта ICertAdmin и снова вызвать этот метод с новой строкой конфигурации.

[in] RequestId

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

[in] strCertHash

Строковое значение, представляющее хэш сертификата. Для использования strCertHash необходимо указать нулевое значение в параметре RequestId.

[in] Flags

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

Значение	Значение
CR_IN_BASE64HEADER	Формат BASE64 с началом или концом.
CR_IN_BASE64	Формат BASE64 без начала или конца.
CR_IN_BINARY	Двоичный формат.

Кроме того, следующее значение можно объединить со значением формата с помощью побитовой операции ИЛИ .

Значение	Значение
IKF_OVERWRITE	Все существующие данные в кодировке KRA перезаписываются.

[in] strKey

Строковое значение, представляющее сведения о ключе KRA.

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

None

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	certadm.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certadm.dll

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

ICertAdmin2

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