Store.Open, méthode

[La méthode Open peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Utilisez plutôt la classe X509Store dans l’espace de noms System.Security.Cryptography.X509Certificates .]

La méthode Open ouvre un magasin de certificats spécifié. Par défaut, l’emplacement CAPICOM_CURRENT_USER_STORE et CAPICOM_MY_STORE magasin sont ouverts en lecture seule.

Syntaxe

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

Paramètres

StoreLocation [in, facultatif]

Valeur de l’énumération CAPICOM_STORE_LOCATION qui indique l’emplacement du magasin à ouvrir. La valeur par défaut est CAPICOM_CURRENT_USER_STORE. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	Le magasin est un magasin Active Directory. Aucune erreur ne sera générée si un magasin Active Directory est ouvert en lecture/écriture, mais les modifications apportées au magasin ne seront pas conservées. Les certificats ne peuvent pas être ajoutés ou supprimés des magasins Active Directory.
CAPICOM_CURRENT_USER_STORE	Le magasin est un magasin d’utilisateurs actuel. Un magasin d’utilisateurs actuel peut être un magasin en lecture/écriture. Si c’est le cas, les modifications apportées au contenu du magasin sont conservées.
CAPICOM_LOCAL_MACHINE_STORE	Le magasin est un magasin d’ordinateurs locaux. Les magasins d’ordinateurs locaux peuvent être des magasins en lecture/écriture uniquement si l’utilisateur dispose d’autorisations de lecture/écriture. Si l’utilisateur dispose d’autorisations de lecture/écriture et si le magasin est ouvert en lecture/écriture, les modifications apportées au contenu du magasin sont conservées.
CAPICOM_MEMORY_STORE	Le magasin est un magasin de mémoire. Les modifications apportées au contenu du magasin ne sont pas conservées.
CAPICOM_SMART_CARD_USER_STORE	Le magasin est le groupe de cartes à puce présentes. Introduit dans CAPICOM 2.0.

 

StoreName [in, facultatif]

Chaîne qui contient le nom du magasin de certificats système à ouvrir. La valeur par défaut est CAPICOM_MY_STORE. Si le magasin est ouvert à partir d’un script web, la barre oblique inverse (\) n’est pas autorisée dans le nom. Outre les magasins définis par le système, les magasins définis par l’utilisateur peuvent être ouverts.

Ce paramètre peut être un magasin défini par l’utilisateur ou l’un des magasins de certificats système suivants.

Valeur	Signification
CAPICOM_CA_STORE	Magasin d’autorité de certification. Ce magasin est utilisé pour stocker les certificats d’autorité de certification intermédiaires.
CAPICOM_MY_STORE	Mon magasin. Ce magasin est utilisé pour les certificats personnels d’un utilisateur.
CAPICOM_OTHER_STORE	Magasin d’adresses. Ce magasin est utilisé pour conserver les certificats d’autres utilisateurs.
CAPICOM_ROOT_STORE	Magasin racine. Ce magasin est utilisé pour stocker l’autorité de certification racine et les certificats approuvés auto-signés.

 

OpenMode [in, facultatif]

Valeur de l’énumération CAPICOM_STORE_OPEN_MODE qui indique le mode ouvert du magasin. La valeur par défaut est CAPICOM_STORE_OPEN_READ_ONLY. Si le magasin est ouvert à partir d’un script web, cette valeur est forcée à CAPICOM_STORE_OPEN_EXISTING_ONLY. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED	Ouvrez le magasin en mode lecture/écriture si l’utilisateur dispose d’autorisations de lecture/écriture ; sinon, ouvrez le magasin en mode lecture seule.
CAPICOM_STORE_OPEN_READ_ONLY	Ouvrez le magasin en lecture seule.
CAPICOM_STORE_OPEN_READ_WRITE	Ouvrez le magasin en mode lecture/écriture.

 

Les indicateurs suivants peuvent être combinés avec les valeurs du tableau précédent à l’aide d’une opération logique-OR .

Valeur	Signification
CAPICOM_STORE_OPEN_EXISTING_ONLY	Ouvrez des magasins existants uniquement ; ne créez pas de magasin. Introduit dans CAPICOM 2.0.
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED	Incluez les certificats archivés lors de l’utilisation du magasin. Introduit dans CAPICOM 2.0.

 

Les magasins dans certains emplacements peuvent être ouverts uniquement en mode lecture seule. Celles-ci incluent tous les magasins dans CAPICOM_LOCAL_MACHINE_STORE pour lesquels l’utilisateur ne dispose pas d’autorisations d’écriture. Les tentatives d’ouverture d’un magasin en tant que magasin en lecture/écriture sans accès et autorisations appropriés entraînent l’échec de la méthode Open . Les magasins Active Directory peuvent être ouverts en tant que magasin de lecture/écriture sans échec de la méthode Open , mais les modifications apportées au magasin ne sont pas conservées.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Si cette méthode est appelée dans un magasin de cartes à puce, des interfaces utilisateur de carte à puce supplémentaires peuvent être appelées.

Si StoreLocation est CAPICOM_SMART_CARD_USER_STORE, StoreName est ignoré. Dans ce cas, CAPICOM lit tous les certificats de tous les lecteurs disponibles qui contiennent un carte intelligent.

Spécifications

Voir aussi

Magasin

Objets de chiffrement

Close