CertIsStrongHashToSign-Funktion (wincrypt.h)

Artikel
03/03/2024

Bestimmt, ob der angegebene Hashalgorithmus und der öffentliche Schlüssel im Signaturzertifikat verwendet werden können, um eine starke Signatur durchzuführen.

Syntax

BOOL CertIsStrongHashToSign(
  [in]           PCCERT_STRONG_SIGN_PARA pStrongSignPara,
  [in]           LPCWSTR                 pwszCNGHashAlgid,
  [in, optional] PCCERT_CONTEXT          pSigningCert
);

Parameter

[in] pStrongSignPara

Zeiger auf eine CERT_STRONG_SIGN_PARA Struktur, die Informationen zu unterstützten Signatur- und Hashingalgorithmen enthält.

[in] pwszCNGHashAlgid

Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Hashingalgorithmus enthält. Die folgenden Algorithmen werden unterstützt:

L"MD5" (BCRYPT_MD5_ALGORITHM)
L"SHA1" (BCRYPT_SHA1_ALGORITHM)
L"SHA256" (BCRYPT_SHA256_ALGORITHM)
L"SHA256" (BCRYPT_SHA256_ALGORITHM)
L"SHA512" (BCRYPT_SHA512_ALGORITHM)

[in, optional] pSigningCert

Zeiger auf eine CERT_CONTEXT-Struktur , die das Signaturzertifikat enthält. Der Public Key-Algorithmus im Signaturzertifikat wird auf Seine Stärke überprüft. Der Algorithmus für öffentliche Schlüssel (asymmetrisch) wird zum Signieren verwendet. Die folgenden Signaturalgorithmen werden unterstützt:

L"RSA" (BCRYPT_RSA_ALGORITHM)
L"DSA" (BCRYPT_DSA_ALGORITHM)
L"ECDSA" (SSL_ECDSA_ALGORITHM)

Dieser Parameter kann NULL sein, wenn Sie nur überprüfen möchten, ob der Hashingalgorithmus stark ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Diese Funktion weist die folgenden Fehlercodes auf.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens eines der Eingabeargumente ist nicht korrekt.
NTE_BAD_ALGID	Ein angegebener Algorithmus wird nicht unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

CERT_STRONG_SIGN_PARA

Freigeben über