CryptGetUserKey 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 Cryptography Next Generation API 사용을 시작해야 합니다. Microsoft는 향후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptGetUserKey 함수는 사용자의 두 퍼블릭/프라이빗 키 쌍 중 하나의 핸들을 검색합니다. 이 함수는 퍼블릭/프라이빗 키 쌍의 소유자에 의해서만 사용되며 CSP( 암호화 서비스 공급자 ) 및 관련 키 컨테이너 의 핸들을 사용할 수 있는 경우에만 사용됩니다. CSP 핸들을 사용할 수 없으며 사용자의 인증서가 있는 경우 CryptAcquireCertificatePrivateKey를 사용합니다.

구문

BOOL CryptGetUserKey(
  [in]  HCRYPTPROV hProv,
  [in]  DWORD      dwKeySpec,
  [out] HCRYPTKEY  *phUserKey
);

매개 변수

[in] hProv

CryptAcquireContext를 호출하여 만든 CSP(암호화 서비스 공급자)의 HCRYPTPROV 핸들입니다.

[in] dwKeySpec

키 컨테이너에서 사용할 프라이빗 키를 식별합니다. AT_KEYEXCHANGE 또는 AT_SIGNATURE 수 있습니다.

또한 일부 공급자는 이 함수를 통해 다른 사용자별 키에 대한 액세스를 허용합니다. 자세한 내용은 특정 공급자에 대한 설명서를 참조하세요.

[out] phUserKey

검색된 키의 HCRYPTKEY 핸들에 대한 포인터입니다. 키 사용을 마쳤으면 CryptDestroyKey 함수를 호출하여 핸들을 삭제합니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값(TRUE)입니다.

함수가 실패하면 반환 값은 0(FALSE)입니다. 확장 오류 정보는 GetLastError를 호출합니다.

"NTE"가 앞에 있는 오류 코드는 사용 중인 특정 CSP에 의해 생성됩니다. 몇 가지 가능한 오류 코드는 다음과 같습니다.

반환 코드 설명
ERROR_INVALID_HANDLE
 매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다.
ERROR_INVALID_PARAMETER
 매개 변수 중 하나에 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다.
NTE_BAD_KEY
 dwKeySpec 매개 변수에는 유효하지 않은 값이 포함되어 있습니다.
NTE_BAD_UID
 hProv 매개 변수에 유효한 컨텍스트 핸들이 없습니다.
NTE_NO_KEY
 dwKeySpec 매개 변수에서 요청한 키가 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Advapi32.lib
DLL Advapi32.dll

추가 정보

CryptAcquireContext

CryptDestroyKey

CryptGenKey

키 생성 및 Exchange 함수