SslSignHash-Funktion

Die SslSignHash-Funktion signiert einen Hash mithilfe des angegebenen privaten Schlüssels. Der Signierungsprozess 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]

Das Handle für die SSL-Protokollanbieterinstanz (Secure Sockets Layer Protocol).

hPrivateKey [ In]

Das Handle für 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 Hash empfängt. Der cbSignature-Parameter enthält die Größe dieses Puffers. Um die erforderliche Größe des Puffers zu bestimmen, legen Sie den parameter pbSignature auf NULL fest. Die erforderliche Größe des Puffers wird im parameter pwResult zurückgegeben.

cbSignature [ In]

Die Größe des pbSignature-Puffers in Bytes.

resultsResult [ 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 0 (null) zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich 0 (null) zurückgegeben.

Mögliche Rückgabecodes sind u. a. folgende.

Rückgabecode/-wert Beschreibung
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Einer der bereitgestellten Handles ist ungültig.

Anforderungen

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