Función SslSignHash

La función SslSignHash firma un hash mediante la clave privada especificada. El proceso de firma se realiza en el servidor.

Sintaxis

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]

Identificador de la instancia del proveedor del protocolo Secure Sockets Layer (SSL).

hPrivateKey [in]

Identificador de la clave privada que se va a usar para firmar el hash.

pbHashValue [in]

Puntero a un búfer que contiene el hash que se va a firmar.

cbHashValue [in]

Tamaño, en bytes, del búfer pbHashValue .

pbSignature [out]

Dirección de un búfer que recibe la firma del hash. El parámetro cbSignature contiene el tamaño de este búfer. Para determinar el tamaño necesario del búfer, establezca el parámetro pbSignature enNULL. El tamaño necesario del búfer se devolverá en el parámetro pcbResult .

cbSignature [in]

Tamaño, en bytes, del búfer pbSignature .

pcbResult [out]

Puntero a un valor que, al finalizar, contiene el número real de bytes escritos en el búfer pbSignature .

dwFlags [in]

Este parámetro se reserva para uso futuro.

Valor devuelto

Si la función se ejecuta correctamente, devuelve cero.

Si se produce un error en la función, devuelve un valor de error distinto de cero.

Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.

Código o valor devuelto	Descripción
NTE_INVALID_HANDLE 0x80090026L	Uno de los identificadores proporcionados no es válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Sslprovider.h
Archivo DLL	Ncrypt.dll