다음을 통해 공유

PrivateKey.Open 메서드

  • 아티클

[ Open 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 대신 System.Security.Cryptography.X509Certificates 네임스페이스에서 X509Certificate2.PrivateKey 속성을 사용합니다.]

Open 메서드는 기존 키 컨테이너에 액세스합니다. 이 메서드는 지정된 정보를 사용하여 CERT_KEY_PROV_INFO_PROP_ID 속성을 추가하여 키 컨테이너를 프라이빗 키에 해당하는 인증서에 연결합니다.

구문

PrivateKey.Open( _
  ByVal ContainerName, _
  [ ByVal ProviderName ], _
  [ ByVal ProviderType ], _
  [ ByVal KeySpec ], _
  [ ByVal StoreLocation ], _
  [ ByVal bCheckExistence ] _
)

매개 변수

ContainerName [in]

키 컨테이너의 이름을 포함하는 문자열입니다.

ProviderName [in, optional]

공급자의 이름을 포함하는 문자열입니다. 기본값은 CAPICOM_PROV_MS_ENHANCED_PROV. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
CAPICOM_PROV_MS_DEF_PROV
 Microsoft 기본 암호화 공급자.
CAPICOM_PROV_MS_ENHANCED_PROV
 Microsoft의 향상된 암호화 공급자.
CAPICOM_PROV_MS_STRONG_PROV
 Microsoft의 강력한 암호화 공급자입니다.
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV
 Microsoft RSA 서명 암호화 공급자.
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV
 Microsoft RSA Schannel 암호화 공급자.
CAPICOM_PROV_MS_DEF_DSS_PROV
 Microsoft 기본 DSS 암호화 공급자.
CAPICOM_PROV_MS_DEF_DSS_DH_PROV
 Microsoft 기본 DSS 및 Diffie-Hellman 암호화 공급자.
CAPICOM_PROV_MS_ENH_DSS_DH_PROV
 Microsoft의 향상된 DSS 및 Diffie-Hellman 암호화 공급자.
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV
 Microsoft DH Schannel 암호화 공급자.
CAPICOM_PROV_MS_SCARD_PROV
 Microsoft 기본 스마트 카드 암호화 공급자.
CAPICOM_PROV_MS_ENH_RSA_AES_PROV
 Microsoft의 향상된 RSA 및 AES 암호화 공급자.

 

ProviderType [in, optional]

공급자 형식을 지정하는 CAPICOM_PROV_TYPE 열거형의 값입니다. 기본값은 CAPICOM_PROV_RSA_FULL. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
CAPICOM_PROV_RSA_FULL
 전체 RSA CSP(암호화 서비스 공급자)입니다. 이 공급자 유형은 디지털 서명 과 데이터 암호화를 모두 지원합니다.
CAPICOM_PROV_RSA_SIG
 해시 및 디지털 서명에 필요한 함수 및 알고리즘만 지원하는 RSA CSP의 하위 집합입니다.
CAPICOM_PROV_DSS
 DSS( 디지털 서명 표준 ) CSP입니다. 이 공급자 유형은 해시 및 디지털 서명만 지원합니다. DSS는 DSA( 디지털 서명 알고리즘 )를 사용합니다.
CAPICOM_PROV_FORTEZZA
 NIST(National Institute of Standards and Technology)가 소유한 암호화 프로토콜 및 알고리즘을 포함하는 CSP입니다.
CAPICOM_PROV_MS_EXCHANGE
 Microsoft Exchange 메일 응용 프로그램 및 Microsoft Mail과 호환되는 기타 응용 프로그램을 지원하는 CSP입니다.
CAPICOM_PROV_SSL
 SSL( Secure Sockets Layer ) 프로토콜을 지원하는 CSP입니다.
CAPICOM_PROV_RSA_SCHANNEL
 RSA 및 Schannel 프로토콜을 모두 지원하는 CSP입니다.
CAPICOM_PROV_DSS_DH
 DSS 및 Diffie-Hellman 프로토콜을 모두 지원하는 CSP입니다.
CAPICOM_PROV_EC_ECDSA_SIG
 디지털 서명에 필요한 ECDSA(타원 곡선 디지털 서명 알고리즘) 함수 및 알고리즘을 지원하는 CSP입니다.
CAPICOM_PROV_EC_ECNRA_SIG
 디지털 서명에 필요한 ECNRA(타원 곡선 Nyberg-Rueppel 아날로그) 함수 및 알고리즘을 지원하는 CSP입니다.
CAPICOM_PROV_EC_ECDSA_FULL
 전체 ECDSA를 지원하는 CSP입니다.
CAPICOM_PROV_EC_ECNRA_FULL
 전체 ECNRA를 지원하는 CSP입니다.
CAPICOM_PROV_DH_SCHANNEL
 Diffie-Hellman 및 Schannel 프로토콜을 모두 지원하는 CSP입니다.
CAPICOM_PROV_SPYRUS_LYNKS
 SPYRUS LYNKS 카드 디바이스를 지원하는 CSP입니다.
CAPICOM_PROV_RNG
 난수 생성을 처리하는 CSP입니다.
CAPICOM_PROV_INTEL_SEC
 Intel 보안을 제공하는 CSP입니다.
CAPICOM_PROV_REPLACE_OWF
 암호에서 단방향 형식이 생성되는 방식의 대체를 지원하는 CSP입니다.
CAPICOM_PROV_RSA_AES
 AES(Advanced Encryption Standard) 알고리즘을 사용하여 디지털 서명과 데이터 암호화를 모두 지원하는 CSP입니다.

 

KeySpec [in, optional]

프라이빗 키의 형식을 지정하는 CAPICOM_KEY_SPEC 열거형의 값입니다. 기본값은 CAPICOM_KEY_SPEC_SIGNATURE. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
CAPICOM_KEY_SPEC_KEYEXCHANGE
 키는 암호화 및 서명에 사용할 수 있습니다.
CAPICOM_KEY_SPEC_SIGNATURE
 키는 서명에만 사용할 수 있습니다.

 

StoreLocation [in, optional]

키가 있는 저장소의 위치를 지정하는 CAPICOM_STORE_LOCATION 열거형의 값입니다. 기본값은 CAPICOM_CURRENT_USER_STORE. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
CAPICOM_MEMORY_STORE
 저장소는 메모리 저장소입니다. 저장소 콘텐츠의 변경 내용은 유지되지 않습니다.
CAPICOM_LOCAL_MACHINE_STORE
 저장소는 로컬 컴퓨터 저장소입니다. 로컬 컴퓨터 저장소는 사용자에게 읽기/쓰기 권한이 있는 경우에만 읽기/쓰기 저장소가 될 수 있습니다. 사용자에게 읽기/쓰기 권한이 있고 저장소가 읽기/쓰기가 열려 있는 경우 저장소 내용의 변경 내용이 유지됩니다.
CAPICOM_CURRENT_USER_STORE
 저장소는 현재 사용자 저장소입니다. 현재 사용자 저장소는 읽기/쓰기 저장소일 수 있습니다. 이 경우 저장소 내용의 변경 내용이 유지됩니다.
CAPICOM_ACTIVE_DIRECTORY_USER_STORE
 저장소는 Active Directory 저장소입니다. Active Directory 저장소는 읽기 전용 모드에서만 열 수 있습니다. 인증서를 Active Directory 저장소에 추가하거나 제거할 수 없습니다.
CAPICOM_SMART_CARD_USER_STORE
 스토어는 현재 스마트 카드의 그룹입니다. CAPICOM 2.0에 도입되었습니다.

 

bCheckExistence [in, optional]

CAPICOM이 키에 액세스하려고 하는지 여부를 나타내는 부울 값입니다. True이면 CAPICOM이 키에 액세스하려고 시도합니다. 키가 사용자 보호 또는 스마트 카드 또는 다른 디바이스에 있는 경우 대화 상자가 생성될 수 있습니다. 기본값은 False입니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

이 메서드는 웹 기반 애플리케이션에서 스크립팅될 때 CAPICOM_E_NOT_ALLOWED 반환합니다.

요구 사항

요구 사항 값
재배포 가능 파일
 Windows Server 2003 및 Windows XP의 CAPICOM 2.0 이상
DLL
Capicom.dll

추가 정보

PrivateKey

Certificate.HasPrivateKey