Метод 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, используется поставщик шифрования по умолчанию: поставщик 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".

Замечания

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

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• Устаревшиеcsp
• MaxKeyContainerNameLength
• Имя
• Valid
• Версия

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

Требования

См. также

ICspInformation