Função SslOpenPrivateKey
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 |
|---|---|
|
Não há memória suficiente disponível para alocar buffers necessários. |
|
O identificador hSslProvider não é válido. |
|
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 |
|
| DLL |
|