Функция SslOpenPrivateKey

  • Статья

Функция SslOpenPrivateKey открывает дескриптор закрытого ключа.

Синтаксис

SECURITY_STATUS WINAPI SslOpenPrivateKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phPrivateKey,
  _In_  PCCERT_CONTEXT     pCertContext,
  _In_  DWORD              dwFlags
);

Параметры

hSslProvider [in]

Дескриптор экземпляра поставщика протокола SSL.

phPrivateKey [out]

Адрес буфера, в который записывается дескриптор в закрытый ключ.

Завершив использование ключа, вы должны освободить phPrivateKey , вызвав функцию SslFreeObject .

pCertContext [in]

Адрес сертификата, из которого требуется получить закрытый ключ.

dwFlags [in]

Этот параметр зарезервирован для использования в будущем.

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

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

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

Возможные коды возврата включают, помимо прочего, следующие.

Возвращаемый код или значение Описание
NTE_NO_MEMORY
0x8009000EL
 Недостаточно памяти для выделения необходимых буферов.
NTE_INVALID_HANDLE
0x80090026L
 Недопустимый дескриптор hSslProvider .
NTE_INVALID_PARAMETER
0x80090027L
 Параметр phPrivateKey или pCertContext имеет значение NULL.

Комментарии

Полученный закрытый ключ является частью пары открытого и закрытого ключей в сертификате. Эта функция просто извлекает закрытый ключ из сертификата, указанного параметром pCertContext .

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Заголовок
Sslprovider.h
DLL
Ncrypt.dll