ICertificate2::Load-Methode

Artikel
06/13/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 Load-Methode importiert ein Zertifikat aus einer Datei. Diese Methode wurde in CAPICOM 2.0 eingeführt.

Syntax

Certificate.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ], _
  [ ByVal KeyLocation ] _
)

Parameter

FileName [in]

Eine Zeichenfolge, die den Pfad zu einer CER- oder PFX-Datei enthält, die die Zertifikatdaten enthält.

Kennwort [in, optional]

Eine Zeichenfolge, die das Klartextkennwort für die Datei mit dem privaten 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.

KeyStorageFlag [in, optional]

Ein Wert der CAPICOM_KEY_STORAGE_FLAG-Enumeration , die Schlüsselspeicherflags definiert. Der Standardwert ist CAPICOM_KEY_STORAGE_DEFAULT. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
CAPICOM_KEY_STORAGE_DEFAULT	Standardschlüsselspeicher.
CAPICOM_KEY_STORAGE_EXPORTABLE	Der Schlüssel kann exportiert werden.
CAPICOM_KEY_STORAGE_USER_PROTECTED	Der Schlüssel ist vom Benutzer geschützt.

KeyLocation [in, optional]

Ein Wert der CAPICOM_KEY_LOCATION-Enumeration , der Schlüsselspeicherorttypen definiert. Der Standardwert ist CAPICOM_CURRENT_USER_KEY. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
CAPICOM_CURRENT_USER_KEY	Der Schlüssel ist ein Benutzerschlüssel.
CAPICOM_LOCAL_MACHINE_KEY	Der Schlüssel ist ein Computerschlüssel.

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