Metodo Store.Open

[Il metodo Open è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Usare invece la classe X509Store nello spazio dei nomi System.Security.Cryptography.X509Certificates .

Il metodo Open apre un archivio certificati specificato. Per impostazione predefinita, il percorso CAPICOM_CURRENT_USER_STORE e l'archivio CAPICOM_MY_STORE vengono aperti come di sola lettura.

Sintassi

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

Parametri

StoreLocation [in, facoltativo]

Valore dell'enumerazione CAPICOM_STORE_LOCATION che indica la posizione dell'archivio da aprire. Il valore predefinito è CAPICOM_CURRENT_USER_STORE. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	L'archivio è un archivio Active Directory. Nessun errore verrà generato se un archivio di Active Directory viene aperto come lettura/scrittura, ma le modifiche apportate all'archivio non verranno mantenute. I certificati non possono essere aggiunti o rimossi dagli archivi di Active Directory.
CAPICOM_CURRENT_USER_STORE	L'archivio è un archivio utenti corrente. Un archivio utente corrente può essere un archivio di lettura/scrittura. In caso affermativo, le modifiche apportate al contenuto dell'archivio vengono mantenute.
CAPICOM_LOCAL_MACHINE_STORE	L'archivio è un archivio computer locale. Gli archivi computer locali possono essere archivi di lettura/scrittura solo se l'utente dispone di autorizzazioni di lettura/scrittura. Se l'utente dispone di autorizzazioni di lettura/scrittura e se l'archivio viene aperto in lettura/scrittura, le modifiche apportate al contenuto dell'archivio vengono mantenute.
CAPICOM_MEMORY_STORE	L'archivio è un archivio memoria. Le modifiche apportate al contenuto dell'archivio non vengono mantenute.
CAPICOM_SMART_CARD_USER_STORE	L'archivio è il gruppo di smart card presenti. Introdotta in CAPICOM 2.0.

 

StoreName [in, facoltativo]

Stringa contenente il nome dell'archivio certificati di sistema da aprire. Il valore predefinito è CAPICOM_MY_STORE. Se l'archivio viene aperto da uno script Web, il carattere barra rovesciata (\) non è consentito nel nome. Oltre agli archivi definiti dal sistema, gli archivi definiti dall'utente possono essere aperti.

Questo parametro può essere un archivio definito dall'utente o uno degli archivi certificati di sistema seguenti.

Valore	Significato
CAPICOM_CA_STORE	Archivio CA. Questo archivio viene usato per archiviare i certificati CA intermedi.
CAPICOM_MY_STORE	Il mio negozio. Questo archivio viene usato per i certificati personali di un utente.
CAPICOM_OTHER_STORE	IndirizzoBook store. Questo archivio viene usato per mantenere i certificati di altri utenti.
CAPICOM_ROOT_STORE	Archivio radice. Questo archivio viene usato per archiviare la CA radice e i certificati autofirmati.

 

OpenMode [in, facoltativo]

Valore dell'enumerazione CAPICOM_STORE_OPEN_MODE che indica la modalità aperta dell'archivio. Il valore predefinito è CAPICOM_STORE_OPEN_READ_ONLY. Se l'archivio viene aperto da uno script Web, questo valore viene forzato a CAPICOM_STORE_OPEN_EXISTING_ONLY. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED	Aprire l'archivio in modalità di lettura/scrittura se l'utente ha autorizzazioni di lettura/scrittura; in caso contrario, aprire l'archivio in modalità di sola lettura.
CAPICOM_STORE_OPEN_READ_ONLY	Aprire l'archivio in modalità di sola lettura.
CAPICOM_STORE_OPEN_READ_WRITE	Aprire l'archivio in modalità lettura/scrittura.

 

I flag seguenti possono essere combinati con i valori della tabella precedente usando un'operazione logic-OR .

Valore	Significato
CAPICOM_STORE_OPEN_EXISTING_ONLY	Aprire solo archivi esistenti; non creare un nuovo archivio. Introdotta in CAPICOM 2.0.
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED	Includere i certificati archiviati quando si usa l'archivio. Introdotta in CAPICOM 2.0.

 

Gli archivi in alcune posizioni possono essere aperti solo in modalità di sola lettura. Includono tutti gli archivi in CAPICOM_LOCAL_MACHINE_STORE per i quali l'utente non dispone delle autorizzazioni di scrittura. I tentativi di aprire un archivio come archivio di lettura/scrittura senza l'accesso appropriato e le autorizzazioni comportano l'errore del metodo Open . Gli archivi di Active Directory possono essere aperti come archivio di lettura/scrittura senza errori del metodo Open , ma le modifiche apportate all'archivio non verranno mantenute.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Se questo metodo viene chiamato in un archivio SmartCard, è possibile richiamare altre interfacce utente di SmartCard.

Importante

Quando questo metodo viene chiamato da uno script Web, lo script deve accedere ai certificati digitali nel computer locale. Se si consente allo script di accedere ai certificati digitali, il sito Web da cui viene eseguito lo script otterrà anche l'accesso a tutte le informazioni personali archiviate nei certificati. La prima volta che questo metodo viene chiamato da un determinato dominio, viene generata una finestra di dialogo in cui l'utente deve indicare se l'accesso ai certificati deve essere consentito. Archivia aperto da uno script Web forza automaticamente il flag di CAPICOM_STORE_OPEN_EXISTING_ONLY.

 

Se StoreLocation è CAPICOM_SMART_CARD_USER_STORE, StoreName viene ignorato. In questo caso, CAPICOM legge tutti i certificati di tutti i lettori disponibili che contengono una smart card.

Requisiti

Requisito	Valore
Componente ridistribuibile	CAPICOM 2.0 o versione successiva in Windows Server 2003 e Windows XP
DLL	Capicom.dll

Vedi anche

Archivio

Oggetti di crittografia

Chiudi