Функция 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