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 |
|---|---|
|
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 |
|
| DLL |
|