ICertificate2::Load-Methode

  • Artikel

[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