SslSignHash-Funktion

Artikel
01/28/2024

Die SslSignHash-Funktion signiert einen Hash mithilfe des angegebenen privaten Schlüssels. Der Signaturvorgang wird auf dem Server ausgeführt.

Syntax

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
);

Parameter

hSslProvider [in]: The handle to the Secure Sockets Layer protocol (SSL) protocol provider instance.
hPrivateKey [in]: Das Handle an den privaten Schlüssel, der zum Signieren des Hashs verwendet werden soll.
pbHashValue [in]: Ein Zeiger auf einen Puffer, der den zu signierenden Hash enthält.
cbHashValue [in]: Die Größe des PbHashValue-Puffers in Bytes.
pbSignature [out]: Die Adresse eines Puffers, der die Signatur des Hashs empfängt. Der cbSignature-Parameter enthält die Größe dieses Puffers. Um die erforderliche Größe des Puffers zu ermitteln, legen Sie den PbSignature-Parameter auf NULL fest. Die erforderliche Größe des Puffers wird im pcbResult-Parameter zurückgegeben.
cbSignature [in]: Die Größe des PbSignature-Puffers in Bytes.
pcbResult [out]: Ein Zeiger auf einen Wert, der nach Abschluss die tatsächliche Anzahl von Bytes enthält, die in den PbSignature-Puffer geschrieben wurden.
dwFlags [in]: Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie null zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ohne Zero zurückgegeben.

Mögliche Rückgabecodes enthalten, sind jedoch nicht beschränkt auf Folgendes.

Rückgabecode/-wert	BESCHREIBUNG
NTE_INVALID_HANDLE 0x80090026L	Eine der bereitgestellten Ziehpunkte ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll

Freigeben über