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


Метод IX509PrivateKey::Create (certenroll.h)

Метод Create создает асимметричный закрытый ключ.

Синтаксис

HRESULT Create();

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

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

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

Возвращаемый код/значение Описание
HRESULT_FROM_WIN32(ERROR_BUSY)
Дескриптор CSP не равен NULL.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)
Ключ уже существует.

Комментарии

Если свойства CspStatus, ProviderName или ProviderType не заданы, этот метод использует поставщик по умолчанию, размер ключа и значения KeySpec при создании ключа. Например, в новой установке операционной системы поставщик расширенного шифрования (Майкрософт) версии 1.0 является поставщиком по умолчанию.

Если свойство ContainerName не задано, этот метод автоматически создает имя. Созданное имя содержит GUID и, если свойство ContainerNamePrefix не задано , префикс "lp-". Если поставщик является поставщиком смарт-карта, созданное имя не будет превышать значение MaxKeyContainerNameLength, указанное поставщиком. Если созданное имя изначально превышает это значение, оно усекается до сорока символов.

После вызова методов Create или Open невозможно задать следующие свойства. Если вы хотите указать их, это необходимо сделать перед вызовом любого из этих методов.

Требования

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

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

IX509PrivateKey