Метод ISignerCertificate::Initialize (certenroll.h)

Метод Initialize инициализирует объект из сертификата подписи.

Синтаксис

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

Параметры

[in] MachineContext

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

[in] VerifyType

Значение перечисления X509PrivateKeyVerify , указывающее, должен ли закрытый ключ, используемый для подписи сертификата, проверяться и, если да, проверка должна быть автоматической или разрешает вход пользователя.

[in] Encoding

Значение перечисления EncodeType, указывающее тип кодировки Юникода, примененный к строке сертификата в кодировке DER.

[in] strCertificate

Переменная BSTR , содержащая сертификат в кодировке DER.

Начиная с Windows 7 и Windows Server 2008 R2, можно указать отпечатк сертификата или серийный номер, а не закодированный сертификат. Это приводит к тому, что функция будет искать соответствующие локальные хранилища для соответствующего сертификата. Имейте в виду следующие пункты.

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

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

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

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

Замечания

Метод Initialize :

• Проверяет, существует ли закрытый ключ, связанный с сертификатом.
• Создает объект IX509SignatureInformation и назначает его объекту ISignerCertificate .
• Извлекает алгоритм открытого ключа из закрытого ключа.
• Назначает алгоритм открытого ключа объекту IX509SignatureInformation .

Задайте следующие свойства перед вызовом Initialize:

• ParentWindow
• Закрепить
• Silent
• UIContextMessage

Требования

См. также

ISignerCertificate