Função SslOpenPrivateKey

  • Artigo

A função SslOpenPrivateKey abre um identificador para uma chave privada.

Sintaxe

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

Parâmetros

hSslProvider [in]

O identificador para a instância do provedor de protocolo SSL ( Secure Sockets Layer ).

phPrivateKey [out]

O endereço de um buffer no qual gravar o identificador na chave privada.

Quando terminar de usar a chave, você deverá liberar phPrivateKey chamando a função SslFreeObject .

pCertContext [in]

O endereço do certificado do qual obter a chave privada.

dwFlags [in]

Esse parâmetro é reservado para uso futuro.

Valor retornado

Se a função for bem-sucedida, ela retornará zero.

Se a função falhar, ela retornará um valor de erro diferente de zero.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Retornar código/valor Descrição
NTE_NO_MEMORY
0x8009000EL
 Não há memória suficiente disponível para alocar buffers necessários.
NTE_INVALID_HANDLE
0x80090026L
 O identificador hSslProvider não é válido.
NTE_INVALID_PARAMETER
0x80090027L
 O parâmetro phPrivateKey ou pCertContext é NULL.

Comentários

A chave privada obtida faz parte de um par de chaves pública/privada dentro de um certificado. Essa função apenas extrai a chave privada do certificado especificado pelo parâmetro pCertContext .

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Sslprovider.h
DLL
Ncrypt.dll