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

Метод ICspInformation::InitializeFromType (certenroll.h)

  • Статья

Метод InitializeFromType инициализирует объект из поставщика шифрования по умолчанию.

Синтаксис

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Параметры

[in] Type

Значение перечисления X509ProviderType , определяющее тип поставщика.

  • Если указать XCN_PROV_NONE и задать для параметра pAlgorithm значение, отличное от NULL, используется поставщик API шифрования по умолчанию: следующее поколение (CNG).
  • Если указать значение, отличное от XCN_PROV_NONE, и задать для параметра pAlgorithmзначение NULL, используется устаревший поставщик служб шифрования (CSP) по умолчанию.

[in, optional] pAlgorithm

Указатель на интерфейс IObjectId , представляющий OID алгоритма. Этот параметр является необязательным и может иметь значение NULL. Дополнительные сведения см. в разделе Параметр Type .

[in] MachineContext

Переменная VARIANT_BOOL , указывающая, следует ли использовать контекст компьютера или пользователя для определения поставщика по умолчанию для указанного типа поставщика. Укажите VARIANT_TRUE для компьютера и VARIANT_FALSE для пользователя.

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

Если функция завершается успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Возвращаемый код/значение Описание
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Объект уже инициализирован.

Комментарии

Метод InitializeFromType проверяет указанный тип и сохраняет его в свойстве Type , получает поставщика по умолчанию и задает следующие значения свойств для объекта ICspInformation :

Метод добавляет доступные алгоритмы в коллекцию ICspAlgorithms , возвращаемую свойством CspAlgorithms . Вызовите метод InitializeFromName , чтобы инициализировать объект из имени CSP.

Требования

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

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

ICspInformation