CertAddEncodedCertificateToSystemStoreA-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertAddEncodedCertificateToSystemStore-Funktion öffnet den angegebenen Systemspeicher und fügt diesem das codierte Zertifikat hinzu.

Syntax

BOOL CertAddEncodedCertificateToSystemStoreA(
  [in] LPCSTR     szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Parameter

[in] szCertStoreName

Eine NULL-endende Zeichenfolge, die den Namen des Systemspeichers für das codierte Zertifikat enthält.

[in] pbCertEncoded

Ein Zeiger auf einen Puffer, der das hinzuzufügende codierte Zertifikat enthält.

[in] cbCertEncoded

Die Größe des pbCertEncoded-Puffers in Byte .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. CertAddEncodedCertificateToSystemStore hängt von den Funktionen ab, die in den folgenden Hinweisen zur Fehlerbehandlung aufgeführt sind. Informationen zum jeweiligen Fehlerbehandlungsverhalten finden Sie in diesen Funktionsthemen. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Intern ruft CertAddEncodedCertificateToSystemStoreCertOpenSystemStore und CertAddEncodedCertificateToStore mit den folgenden Parametern auf.

CertOpenSystemStore Parameter	Wert
szSubsystemProtocol	szCertStoreName

Wenn CertAddEncodedCertificateToSystemStore ein Handle für den angegebenen Systemspeicher abruft, wird CertCloseStore aufgerufen, um das Handle vor der Rückgabe zu schließen.

CertAddEncodedCertificateToStore Parameter	Wert
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

Hinweis

Der wincrypt.h-Header definiert CertAddEncodedCertificateToSystemStore als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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

Share via