Store.Open-Methode

[Die Open-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Verwenden Sie stattdessen die X509Store-Klasse im System.Security.Cryptography.X509Certificates-Namespace .]

Die Open-Methode öffnet einen angegebenen Zertifikatspeicher. Standardmäßig werden der CAPICOM_CURRENT_USER_STORE Speicherort und CAPICOM_MY_STORE Store schreibgeschützt geöffnet.

Syntax

Store.Open( _
  [ ByVal StoreLocation ], _
  [ ByVal StoreName ], _
  [ ByVal OpenMode ] _
)

Parameter

StoreLocation [in, optional]

Ein Wert der CAPICOM_STORE_LOCATION-Enumeration , der den Speicherort des zu öffnenden Speichers angibt. Der Standardwert ist CAPICOM_CURRENT_USER_STORE. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	Der Speicher ist ein Active Directory-Speicher. Es wird kein Fehler generiert, wenn ein Active Directory-Speicher als Lese-/Schreibzugriff geöffnet wird. Änderungen am Speicher werden jedoch nicht beibehalten. Zertifikate können nicht zu Active Directory-Speicher hinzugefügt oder daraus entfernt werden.
CAPICOM_CURRENT_USER_STORE	Der Speicher ist ein aktueller Benutzerspeicher. Ein aktueller Benutzerspeicher kann ein Lese-/Schreibspeicher sein. Wenn dies der Grund ist, werden Änderungen am Inhalt des Speichers beibehalten.
CAPICOM_LOCAL_MACHINE_STORE	Der Speicher ist ein lokaler Computerspeicher. Lokale Computerspeicher können nur Lese-/Schreibspeicher sein, wenn der Benutzer über Lese-/Schreibberechtigungen verfügt. Wenn der Benutzer über Lese-/Schreibberechtigungen verfügt und der Speicher mit Lese-/Schreibzugriff geöffnet wird, werden Änderungen am Inhalt des Speichers beibehalten.
CAPICOM_MEMORY_STORE	Der Speicher ist ein Speicher. Änderungen am Inhalt des Speichers werden nicht beibehalten.
CAPICOM_SMART_CARD_USER_STORE	Der Store ist die Gruppe der vorhandenen Smartcards. Eingeführt in CAPICOM 2.0.

 

StoreName [in, optional]

Eine Zeichenfolge, die den Namen des zu öffnenden Systemzertifikatspeichers enthält. Der Standardwert ist CAPICOM_MY_STORE. Wenn der Speicher über ein Webskript geöffnet wird, ist der umgekehrte Schrägstrich (\) im Namen nicht zulässig. Zusätzlich zu den vom System definierten Speichern können benutzerdefinierte Speicher geöffnet werden.

Dieser Parameter kann ein benutzerdefinierter Speicher oder einer der folgenden Systemzertifikatspeicher sein.

Wert	Bedeutung
CAPICOM_CA_STORE	Ca-Speicher. Dieser Speicher wird verwendet, um Zwischenzertifikate der Zertifizierungsstelle zu speichern.
CAPICOM_MY_STORE	Mein Geschäft. Dieser Speicher wird für die persönlichen Zertifikate eines Benutzers verwendet.
CAPICOM_OTHER_STORE	Adressbuchspeicher. Dieser Speicher wird verwendet, um die Zertifikate anderer Zu speichern.
CAPICOM_ROOT_STORE	Stammspeicher. Dieser Speicher wird verwendet, um die Stammzertifizierungsstelle und selbstsignierte, vertrauenswürdige Zertifikate zu speichern.

 

OpenMode [in, optional]

Ein Wert der CAPICOM_STORE_OPEN_MODE-Enumeration , der den geöffneten Modus des Speichers angibt. Der Standardwert ist CAPICOM_STORE_OPEN_READ_ONLY. Wenn der Speicher über ein Webskript geöffnet wird, muss dieser Wert CAPICOM_STORE_OPEN_EXISTING_ONLY. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED	Öffnen Sie den Speicher im Lese-/Schreibmodus, wenn der Benutzer über Lese-/Schreibberechtigungen verfügt. Öffnen Sie andernfalls den Speicher im schreibgeschützten Modus.
CAPICOM_STORE_OPEN_READ_ONLY	Öffnen Sie den Speicher im schreibgeschützten Modus.
CAPICOM_STORE_OPEN_READ_WRITE	Öffnen Sie den Speicher im Lese-/Schreibmodus.

 

Die folgenden Flags können mithilfe eines logischen OR-Vorgangs mit den Werten in der vorherigen Tabelle kombiniert werden.

Wert	Bedeutung
CAPICOM_STORE_OPEN_EXISTING_ONLY	Öffnen Sie nur vorhandene Filialen; erstellen Sie keinen neuen Speicher. Eingeführt in CAPICOM 2.0.
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED	Schließen Sie archivierte Zertifikate ein, wenn Sie den Speicher verwenden. Eingeführt in CAPICOM 2.0.

 

Geschäfte an einigen Standorten können nur im schreibgeschützten Modus geöffnet werden. Dazu gehören alle Speicher in CAPICOM_LOCAL_MACHINE_STORE, für die der Benutzer keine Schreibberechtigungen hat. Versuche, einen Speicher als Lese-/Schreibspeicher ohne ordnungsgemäßen Zugriff und Berechtigungen zu öffnen, führen zum Ausfall der Open-Methode . Active Directory-Speicher können ohne Fehler der Open-Methode als Lese-/Schreibspeicher geöffnet werden, änderungen am Speicher werden jedoch nicht beibehalten.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Wenn diese Methode in einem SmartCard-Speicher aufgerufen wird, können zusätzliche SmartCard-Benutzeroberflächen aufgerufen werden.

Wichtig

Wenn diese Methode aus einem Webskript aufgerufen wird, muss das Skript auf digitale Zertifikate auf dem lokalen Computer zugreifen. Wenn Sie dem Skript den Zugriff auf Ihre digitalen Zertifikate gestatten, erhält die Website, von der aus das Skript ausgeführt wird, auch Zugriff auf alle persönlichen Informationen, die in den Zertifikaten gespeichert sind. Wenn diese Methode zum ersten Mal aus einer bestimmten Domäne aufgerufen wird, wird ein Dialogfeld generiert, in dem der Benutzer angeben muss, ob der Zugriff auf die Zertifikate zulässig sein soll. Von einem Webskript geöffnete Speicher erzwingen automatisch das flag CAPICOM_STORE_OPEN_EXISTING_ONLY.

 

Wenn StoreLocationCAPICOM_SMART_CARD_USER_STORE ist, wird StoreName ignoriert. In diesem Fall liest CAPICOM alle Zertifikate von allen verfügbaren Lesern, die eine intelligente Karte enthalten.

Anforderungen

Anforderung	Wert
Verteilbare Komponente	CAPICOM 2.0 oder höher unter Windows Server 2003 und Windows XP
DLL	Capicom.dll

Siehe auch

Speicher

Kryptografieobjekte

Schließen