Store.Open 메서드
[ Open 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 대신 System.Security.Cryptography.X509Certificates 네임스페이스에서 X509Store클래스를 사용합니다.]
Open 메서드는 지정된 인증서 저장소를 엽니다. 기본적으로 CAPICOM_CURRENT_USER_STORE 위치 및 CAPICOM_MY_STORE 저장소는 읽기 전용으로 열립니다.
구문
Store.Open( _
[ ByVal StoreLocation ], _
[ ByVal StoreName ], _
[ ByVal OpenMode ] _
)
매개 변수
-
StoreLocation [in, optional]
-
열 저장소의 위치를 나타내는 CAPICOM_STORE_LOCATION 열거형의 값입니다. 기본값은 CAPICOM_CURRENT_USER_STORE. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 의미 - CAPICOM_ACTIVE_DIRECTORY_USER_STORE
저장소는 Active Directory 저장소입니다. Active Directory 저장소를 읽기/쓰기로 열면 오류가 생성되지 않지만 저장소에 대한 변경 내용은 유지되지 않습니다. 인증서를 Active Directory 저장소에 추가하거나 제거할 수 없습니다. - CAPICOM_CURRENT_USER_STORE
저장소는 현재 사용자 저장소입니다. 현재 사용자 저장소는 읽기/쓰기 저장소일 수 있습니다. 이 경우 저장소 내용의 변경 내용이 유지됩니다. - CAPICOM_LOCAL_MACHINE_STORE
저장소는 로컬 컴퓨터 저장소입니다. 로컬 컴퓨터 저장소는 사용자에게 읽기/쓰기 권한이 있는 경우에만 읽기/쓰기 저장소가 될 수 있습니다. 사용자에게 읽기/쓰기 권한이 있고 저장소가 읽기/쓰기가 열려 있는 경우 저장소 내용의 변경 내용이 유지됩니다. - CAPICOM_MEMORY_STORE
저장소는 메모리 저장소입니다. 저장소 콘텐츠의 변경 내용은 유지되지 않습니다. - CAPICOM_SMART_CARD_USER_STORE
스토어는 현재 스마트 카드의 그룹입니다. CAPICOM 2.0에 도입되었습니다. -
StoreName [in, optional]
-
열 시스템 인증서 저장소의 이름이 들어 있는 문자열입니다. 기본값은 CAPICOM_MY_STORE. 웹 스크립트에서 저장소를 열면 이름에 백슬래시(\) 문자가 허용되지 않습니다. 시스템에서 정의한 저장소 외에도 사용자 정의 저장소를 열 수 있습니다.
이 매개 변수는 사용자 정의 저장소 또는 다음 시스템 인증서 저장소 중 하나일 수 있습니다.
값 의미 - CAPICOM_CA_STORE
CA 저장소. 이 저장소는 중간 CA 인증서를 저장하는 데 사용됩니다. - CAPICOM_MY_STORE
내 상점. 이 저장소는 사용자의 개인 인증서에 사용됩니다. - CAPICOM_OTHER_STORE
AddressBook 저장소. 이 저장소는 다른 사람의 인증서를 유지하는 데 사용됩니다. - CAPICOM_ROOT_STORE
루트 저장소. 이 저장소는 루트 CA 및 자체 서명된 신뢰할 수 있는 인증서를 저장하는 데 사용됩니다. -
OpenMode [in, optional]
-
저장소의 열기 모드를 나타내는 CAPICOM_STORE_OPEN_MODE 열거형의 값입니다. 기본값은 CAPICOM_STORE_OPEN_READ_ONLY. 웹 스크립트에서 저장소를 열면 이 값은 강제로 CAPICOM_STORE_OPEN_EXISTING_ONLY. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 의미 - CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED
사용자에게 읽기/쓰기 권한이 있는 경우 읽기/쓰기 모드로 저장소를 엽니다. 그렇지 않으면 읽기 전용 모드로 저장소를 엽니다. - CAPICOM_STORE_OPEN_READ_ONLY
읽기 전용 모드로 저장소를 엽니다. - CAPICOM_STORE_OPEN_READ_WRITE
읽기/쓰기 모드로 저장소를 엽니다. 다음 플래그는 논리 OR 연산을 사용하여 이전 테이블의 값과 결합할 수 있습니다.
값 의미 - CAPICOM_STORE_OPEN_EXISTING_ONLY
기존 저장소만 엽니다. 새 저장소를 만들지 마세요. CAPICOM 2.0에 도입되었습니다. - CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED
저장소를 사용할 때 보관된 인증서를 포함합니다. CAPICOM 2.0에 도입되었습니다. 일부 위치에 있는 저장소는 읽기 전용 모드에서만 열 수 있습니다. 여기에는 사용자에게 쓰기 권한이 없는 CAPICOM_LOCAL_MACHINE_STORE 모든 저장소가 포함됩니다. 적절한 액세스 권한 없이 읽기/쓰기 저장소로 저장소를 열려고 하면 Open 메서드가 실패합니다. Active Directory 저장소는 Open 메서드의 실패 없이 읽기/쓰기 저장소로 열 수 있지만 저장소에 대한 변경 내용은 유지되지 않습니다.
반환 값
이 메서드는 값을 반환하지 않습니다.
설명
이 메서드가 SmartCard 저장소에서 호출되면 추가 SmartCard 사용자 인터페이스가 호출될 수 있습니다.
중요
이 메서드가 웹 스크립트에서 호출되면 스크립트는 로컬 컴퓨터의 디지털 인증서에 액세스해야 합니다. 스크립트가 디지털 인증서에 액세스하도록 허용하는 경우 스크립트가 실행되는 웹 사이트에서도 인증서에 저장된 개인 정보에 액세스할 수 있습니다. 이 메서드가 특정 도메인에서 처음 호출되면 사용자가 인증서에 대한 액세스를 허용할지 여부를 나타내야 하는 대화 상자가 생성됩니다. 웹 스크립트에서 열린 저장소는 자동으로 CAPICOM_STORE_OPEN_EXISTING_ONLY 플래그를 강제로 적용합니다.
StoreLocation이 CAPICOM_SMART_CARD_USER_STORE 경우 StoreName은 무시됩니다. 이 경우 CAPICOM은 스마트 카드 포함하는 사용 가능한 모든 판독기에서 모든 인증서를 읽습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 재배포 가능 파일 |
Windows Server 2003 및 Windows XP의 CAPICOM 2.0 이상 |
| DLL |
|
추가 정보