CryptGetUserKey 함수(wincrypt.h)
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 Cryptography Next Generation API 사용을 시작해야 합니다. Microsoft는 향후 릴리스에서 이 API를 제거할 수 있습니다.
구문
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에 의해 생성됩니다. 몇 가지 가능한 오류 코드는 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다. |
|
매개 변수 중 하나에 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다. |
|
dwKeySpec 매개 변수에는 유효하지 않은 값이 포함되어 있습니다. |
|
hProv 매개 변수에 유효한 컨텍스트 핸들이 없습니다. |
|
dwKeySpec 매개 변수에서 요청한 키가 없습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wincrypt.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |