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
Capicom.dll

추가 정보

스토어

암호화 개체

닫기