The Open method opens a specified certificate store. By default, the CAPICOM_CURRENT_USER_STORE location and CAPICOM_MY_STORE store are opened as read-only.
- StoreLocation [in, optional]
A value of the CAPICOM_STORE_LOCATION enumeration that indicates the location of the store to be opened. The default value is CAPICOM_CURRENT_USER_STORE. This parameter can be one of the following values.
- StoreName [in, optional]
A string that contains the name of the system certificate store to be opened. The default value is CAPICOM_MY_STORE. If the store is opened from a web script, the backslash (\) character is not allowed in the name. In addition to stores defined by the system, user-defined stores can be opened.
This parameter can be a user-defined store or one of the following system certificate stores.
- OpenMode [in, optional]
A value of the CAPICOM_STORE_OPEN_MODE enumeration that indicates the open mode of the store. The default value is CAPICOM_STORE_OPEN_READ_ONLY. If the store is opened from a web script, this value is forced to CAPICOM_STORE_OPEN_EXISTING_ONLY. This parameter can be one of the following values.
The following flags can be combined with the values in the previous table by using a logical-OR operation.
Open existing stores only; do not create a new store. Introduced in CAPICOM 2.0.
Include archived certificates when using the store. Introduced in CAPICOM 2.0.
Stores in some locations can be opened only in read-only mode. These include all stores in CAPICOM_LOCAL_MACHINE_STORE for which the user does not have write permissions. Attempts to open a store as a read/write store without proper access and permissions will result in the failure of the Open method. Active Directory stores can be opened as a read/write store without failure of the Open method, but changes to the store will not be persisted.
This method does not return a value.
If this method is called on a SmartCard store, additional SmartCard user interfaces may be invoked.
If StoreLocation is CAPICOM_SMART_CARD_USER_STORE, StoreName is ignored. In this case, CAPICOM reads all certificates from all available readers that contain a smart card.
CAPICOM 2.0 or later on Windows Server 2003 and Windows XP