CertAddEncodedCertificateToSystemStoreW-Funktion (wincrypt.h)

Artikel
03/03/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 NULL-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 Puffers pbCertEncoded in Bytes.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. CertAddEncodedCertificateToSystemStore ist für die Fehlerbehandlung von den in den folgenden Hinweisen aufgeführten Funktionen abhängig. Informationen zu den 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 zu schließen, bevor es zurückgegeben wird.

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 nicht codierungsneutralem Code 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
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