Função SslSignHash
A função SslSignHash assina um hash usando a chave privada especificada. O processo de assinatura é executado no servidor.
Sintaxe
SECURITY_STATUS WINAPI SslSignHash(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ NCRYPT_KEY_HANDLE hPrivateKey,
_In_ PBYTE pbHashValue,
_In_ DWORD cbHashValue,
_Out_ PBYTE pbSignature,
_In_ DWORD cbSignature,
_Out_ DWORD *pcbResult,
_In_ DWORD dwFlags
);
Parâmetros
-
hSslProvider [in]
-
O identificador para a instância do provedor de protocolo SSL .
-
hPrivateKey [in]
-
O identificador para a chave privada a ser usada para assinar o hash.
-
pbHashValue [in]
-
Um ponteiro para um buffer que contém o hash a ser assinado.
-
cbHashValue [in]
-
O tamanho, em bytes, do buffer pbHashValue .
-
pbSignature [out]
-
O endereço de um buffer que recebe a assinatura do hash. O parâmetro cbSignature contém o tamanho desse buffer. Para determinar o tamanho do tamanho necessário do buffer, defina o parâmetro pbSignature como NULL. O tamanho necessário do buffer será retornado no parâmetro pcbResult .
-
cbSignature [in]
-
O tamanho, em bytes, do buffer pbSignature .
-
pcbResult [out]
-
Um ponteiro para um valor que, após a conclusão, contém o número real de bytes gravados no buffer pbSignature .
-
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.
| Código/valor de retorno | Descrição |
|---|---|
|
Um dos identificadores fornecidos não é válido. |
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 |
|