ICertificate2::Save-Methode

Artikel
06/12/2023

[CAPICOM ist eine 32-Bit-Komponente, die in den folgenden Betriebssystemen verfügbar ist: Windows Server 2008, Windows Vista und Windows XP. Verwenden Sie stattdessen die X509Certificate2-Klasse im System.Security.Cryptography.X509Certificates-Namespace .]

Die Save-Methode speichert das Zertifikat in einer Datei. Diese Methode wurde in CAPICOM 2.0 eingeführt.

Syntax

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Parameter

FileName [in]

Eine Zeichenfolge, die den Namen der Ausgabedatei enthält, in der das Zertifikat gespeichert wird.

Kennwort [in, optional]

Eine Zeichenfolge, die das Klartextkennwort für eine Datei mit privatem Schlüssel enthält. Das Kennwort kann bis zu 32 Unicode-Zeichen enthalten, einschließlich eines abschließenden NULL-Zeichens. Informationen zum Schutz des Kennworts finden Sie unter Behandeln von Kennwörtern.

SaveAs [in, optional]

Ein Wert der CAPICOM_CERTIFICATE_SAVE_AS_TYPE-Enumeration , der das Format der Ausgabedatei angibt. Der Standardwert ist CAPICOM_CERTIFICATE_SAVE_AS_CER. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
CAPICOM_CERTIFICATE_SAVE_AS_CER	Die Ausgabedatei wird als CER-Datei formatiert, ohne dass private Schlüssel gespeichert sind.
CAPICOM_CERTIFICATE_SAVE_AS_PFX	Die Ausgabedatei wird als PFX-Datei (PKCS #12) formatiert, und alle zugeordneten privaten Schlüssel, die exportiert werden können, werden ebenfalls gespeichert.

IncludeOption [in, optional]

Ein Wert der CAPICOM_CERTIFICATE_INCLUDE_OPTION-Enumeration , der angibt, wie viele Zertifikate in der Kette in der Ausgabedatei gespeichert werden. Der Standardwert ist CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT	Speichert alle Zertifikate in der Kette mit Ausnahme der Stammentität.
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN	Speichert die vollständige Zertifikatkette.
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY	Speichert nur das Endentitätszertifikat.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Methode löst CAPICOM_E_NOT_ALLOWED aus, wenn sie von einer webbasierten Anwendung aus erstellt wird.

Anforderungen

Anforderung	Wert
Ende des Supports (Client)	Windows Vista
Ende des Supports (Server)	WindowsServer 2008
Verteilbare Komponente	CAPICOM 2.0 oder höher unter Windows Server 2003 und Windows XP
DLL	Capicom.dll

Freigeben über