Método Store.Open

[El método Open está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En su lugar, use la clase X509Store en el espacio de nombres System.Security.Cryptography.X509Certificates .]

El método Open abre un almacén de certificados especificado. De forma predeterminada, la ubicación de CAPICOM_CURRENT_USER_STORE y CAPICOM_MY_STORE almacén se abren como de solo lectura.

Sintaxis

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

Parámetros

StoreLocation [in, opcional]

Valor de la enumeración CAPICOM_STORE_LOCATION que indica la ubicación del almacén que se va a abrir. El valor predeterminado es CAPICOM_CURRENT_USER_STORE. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	El almacén es un almacén de Active Directory. No se generará ningún error si se abre un almacén de Active Directory como lectura y escritura, pero no se conservará ningún cambio en el almacén. Los certificados no se pueden agregar ni quitar de los almacenes de Active Directory.
CAPICOM_CURRENT_USER_STORE	El almacén es un almacén de usuarios actual. Un almacén de usuarios actual puede ser un almacén de lectura y escritura. Si es así, se conservan los cambios en el contenido del almacén.
CAPICOM_LOCAL_MACHINE_STORE	El almacén es un almacén de equipos local. Los almacenes de equipos locales solo pueden ser almacenes de lectura y escritura si el usuario tiene permisos de lectura y escritura. Si el usuario tiene permisos de lectura y escritura y si el almacén se abre de lectura y escritura, se conservan los cambios en el contenido del almacén.
CAPICOM_MEMORY_STORE	El almacén es un almacén de memoria. Los cambios en el contenido del almacén no se conservan.
CAPICOM_SMART_CARD_USER_STORE	La tienda es el grupo de tarjetas inteligentes presentes. Introducido en CAPICOM 2.0.

 

StoreName [in, opcional]

Cadena que contiene el nombre del almacén de certificados del sistema que se va a abrir. El valor predeterminado es CAPICOM_MY_STORE. Si el almacén se abre desde un script web, el carácter de barra diagonal inversa (\) no se permite en el nombre. Además de los almacenes definidos por el sistema, se pueden abrir almacenes definidos por el usuario.

Este parámetro puede ser un almacén definido por el usuario o uno de los siguientes almacenes de certificados del sistema.

Valor	Significado
CAPICOM_CA_STORE	Almacén de CA. Este almacén se usa para almacenar certificados de ENTIDAD de certificación intermedios.
CAPICOM_MY_STORE	Mi tienda. Este almacén se usa para los certificados personales de un usuario.
CAPICOM_OTHER_STORE	Almacén de libreta de direcciones. Este almacén se usa para mantener los certificados de otros usuarios.
CAPICOM_ROOT_STORE	Almacén raíz. Este almacén se usa para almacenar la entidad de certificación raíz y los certificados de confianza autofirmados.

 

OpenMode [in, opcional]

Valor de la enumeración CAPICOM_STORE_OPEN_MODE que indica el modo abierto del almacén. El valor predeterminado es CAPICOM_STORE_OPEN_READ_ONLY. Si el almacén se abre desde un script web, este valor se fuerza a CAPICOM_STORE_OPEN_EXISTING_ONLY. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED	Abra el almacén en modo de lectura y escritura si el usuario tiene permisos de lectura y escritura; de lo contrario, abra el almacén en modo de solo lectura.
CAPICOM_STORE_OPEN_READ_ONLY	Abra el almacén en modo de solo lectura.
CAPICOM_STORE_OPEN_READ_WRITE	Abra el almacén en modo de lectura y escritura.

 

Las marcas siguientes se pueden combinar con los valores de la tabla anterior mediante una operación or lógica.

Valor	Significado
CAPICOM_STORE_OPEN_EXISTING_ONLY	Abrir solo tiendas existentes; no cree un almacén nuevo. Introducido en CAPICOM 2.0.
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED	Incluir certificados archivados al usar el almacén. Introducido en CAPICOM 2.0.

 

Las tiendas de algunas ubicaciones solo se pueden abrir en modo de solo lectura. Estos incluyen todos los almacenes de CAPICOM_LOCAL_MACHINE_STORE para los que el usuario no tiene permisos de escritura. Los intentos de abrir un almacén como almacén de lectura y escritura sin el acceso adecuado y los permisos producirán el error del método Open . Los almacenes de Active Directory se pueden abrir como un almacén de lectura y escritura sin errores del método Open , pero los cambios en el almacén no se conservarán.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Si se llama a este método en un almacén de SmartCard, se pueden invocar interfaces de usuario adicionales de SmartCard.

Importante

Cuando se llama a este método desde un script web, el script debe tener acceso a los certificados digitales en el equipo local. Si permite que el script acceda a los certificados digitales, el sitio web desde el que se ejecuta el script también obtendrá acceso a cualquier información personal almacenada en los certificados. La primera vez que se llama a este método desde un dominio determinado, se genera un cuadro de diálogo en el que el usuario debe indicar si se debe permitir el acceso a los certificados. Las tiendas abiertas desde un script web fuerzan automáticamente la marca CAPICOM_STORE_OPEN_EXISTING_ONLY.

 

Si StoreLocation está CAPICOM_SMART_CARD_USER_STORE, se omite StoreName . En este caso, CAPICOM lee todos los certificados de todos los lectores disponibles que contienen una tarjeta inteligente.

Requisitos

Requisito	Value
Redistribuible	CAPICOM 2.0 o posterior en Windows Server 2003 y Windows XP
Archivo DLL	Capicom.dll

Consulte también

Tienda

Objetos criptográficos

Cerrar