CertAddEncodedCertificateToSystemStoreW-Funktion (wincrypt.h)

Artikel
11/20/2024

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

Syntax

BOOL CertAddEncodedCertificateToSystemStoreW(
  [in] LPCWSTR    szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Parameter

[in] szCertStoreName

Eine mit Null beendete Zeichenfolge, die den Namen des Systemspeichers für das codierte Zertifikat enthält.

[in] pbCertEncoded

Ein Zeiger auf einen Puffer, der das zu hinzufü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 in den folgenden Hinweisen aufgeführten Funktionen für die Fehlerbehandlung ab. Informationen zu den jeweiligen Fehlerbehandlungsverhaltensweisen finden Sie in diesen Funktionsthemen. Rufen Sie für erweiterte Fehlerinformationen GetLastError-auf.

Bemerkungen

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 zu schließen, bevor es zurückgegeben wird.

CertAddEncodedCertificateToStore Parameter	Wert
dwCertEncodingType-	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext-	NULL-

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincrypt.h
Library	Crypt32.lib
DLL-	Crypt32.dll

Freigeben über