Método Store.Open

[O método Open está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Em vez disso, use a classe X509Store no namespace System.Security.Cryptography.X509Certificates .]

O método Open abre um repositório de certificados especificado. Por padrão, o local CAPICOM_CURRENT_USER_STORE e CAPICOM_MY_STORE repositório são abertos como somente leitura.

Sintaxe

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

Parâmetros

StoreLocation [in, opcional]

Um valor da enumeração CAPICOM_STORE_LOCATION que indica o local do repositório a ser aberto. O valor padrão é CAPICOM_CURRENT_USER_STORE. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	O repositório é um repositório do Active Directory. Nenhum erro será gerado se um repositório do Active Directory for aberto como leitura/gravação, mas as alterações no repositório não serão mantidas. Os certificados não podem ser adicionados ou removidos dos repositórios do Active Directory.
CAPICOM_CURRENT_USER_STORE	O repositório é um repositório de usuários atual. Um repositório de usuários atual pode ser um repositório de leitura/gravação. Se for, as alterações no conteúdo do repositório serão mantidas.
CAPICOM_LOCAL_MACHINE_STORE	O repositório é um repositório de computadores local. Repositórios de computadores locais só poderão ser repositórios de leitura/gravação se o usuário tiver permissões de leitura/gravação. Se o usuário tiver permissões de leitura/gravação e se o repositório estiver aberto de leitura/gravação, as alterações no conteúdo do repositório serão mantidas.
CAPICOM_MEMORY_STORE	O repositório é um repositório de memória. As alterações no conteúdo do repositório não são persistentes.
CAPICOM_SMART_CARD_USER_STORE	A loja é o grupo de cartões inteligentes presentes. Introduzido no CAPICOM 2.0.

 

StoreName [in, opcional]

Uma cadeia de caracteres que contém o nome do repositório de certificados do sistema a ser aberto. O valor padrão é CAPICOM_MY_STORE. Se o repositório for aberto a partir de um script web, o caractere de barra invertida (\) não será permitido no nome. Além dos repositórios definidos pelo sistema, os repositórios definidos pelo usuário podem ser abertos.

Esse parâmetro pode ser um repositório definido pelo usuário ou um dos seguintes repositórios de certificados do sistema.

Valor	Significado
CAPICOM_CA_STORE	Repositório de AC. Esse repositório é usado para armazenar certificados de autoridade de certificação intermediários.
CAPICOM_MY_STORE	Minha loja. Esse repositório é usado para certificados pessoais de um usuário.
CAPICOM_OTHER_STORE	Repositório addressbook. Esse repositório é usado para manter os certificados de outras pessoas.
CAPICOM_ROOT_STORE	Repositório raiz. Esse repositório é usado para armazenar a AC raiz e certificados autoassinados e confiáveis.

 

OpenMode [in, opcional]

Um valor da enumeração CAPICOM_STORE_OPEN_MODE que indica o modo aberto do repositório. O valor padrão é CAPICOM_STORE_OPEN_READ_ONLY. Se o repositório for aberto a partir de um script web, esse valor será forçado a CAPICOM_STORE_OPEN_EXISTING_ONLY. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED	Abra o repositório no modo de leitura/gravação se o usuário tiver permissões de leitura/gravação; caso contrário, abra o repositório no modo somente leitura.
CAPICOM_STORE_OPEN_READ_ONLY	Abra o repositório no modo somente leitura.
CAPICOM_STORE_OPEN_READ_WRITE	Abra o repositório no modo de leitura/gravação.

 

Os sinalizadores a seguir podem ser combinados com os valores na tabela anterior usando uma operação logical-OR .

Valor	Significado
CAPICOM_STORE_OPEN_EXISTING_ONLY	Abrir somente repositórios existentes; não crie um novo repositório. Introduzido no CAPICOM 2.0.
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED	Inclua certificados arquivados ao usar o repositório. Introduzido no CAPICOM 2.0.

 

Repositórios em alguns locais só podem ser abertos no modo somente leitura. Eles incluem todos os repositórios em CAPICOM_LOCAL_MACHINE_STORE para os quais o usuário não tem permissões de gravação. As tentativas de abrir um repositório como um repositório de leitura/gravação sem acesso e permissões adequados resultarão na falha do método Open . Os repositórios do Active Directory podem ser abertos como um repositório de leitura/gravação sem falha do método Open , mas as alterações no repositório não serão mantidas.

Valor retornado

Esse método não retorna um valor.

Comentários

Se esse método for chamado em um repositório SmartCard, interfaces de usuário smartcard adicionais poderão ser invocadas.

Importante

Quando esse método é chamado de um script web, o script precisa acessar certificados digitais no computador local. Se você permitir que o script acesse seus certificados digitais, o site do qual o script é executado também terá acesso a quaisquer informações pessoais armazenadas nos certificados. Na primeira vez que esse método é chamado de um domínio específico, uma caixa de diálogo é gerada na qual o usuário deve indicar se o acesso aos certificados deve ser permitido. As lojas abertas de um script Web forçam automaticamente o sinalizador CAPICOM_STORE_OPEN_EXISTING_ONLY.

 

Se StoreLocation for CAPICOM_SMART_CARD_USER_STORE, StoreName será ignorado. Nesse caso, o CAPICOM lê todos os certificados de todos os leitores disponíveis que contêm uma cartão inteligente.

Requisitos

Requisito	Valor
Redistribuível	CAPICOM 2.0 ou posterior no Windows Server 2003 e Windows XP
DLL	Capicom.dll

Confira também

Repositório

Objetos de criptografia

Fechar