CryptReleaseContext 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 암호화 차세대 API 사용을 시작해야 합니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptReleaseContext 함수는 CSP(암호화 서비스 공급자) 및 키 컨테이너의 핸들을 해제합니다. 이 함수를 호출할 때마다 CSP의 참조 수가 1씩 줄어듭니다. 참조 수가 0에 도달하면 컨텍스트 가 완전히 해제되고 애플리케이션의 함수에서 더 이상 사용할 수 없습니다.

애플리케이션은 CSP 사용을 완료한 후 이 함수를 호출합니다. 이 함수가 호출되면 릴리스된 CSP 핸들이 더 이상 유효하지 않습니다. 이 함수는 키 컨테이너 또는 키 쌍을 삭제하지 않습니다.

구문

BOOL CryptReleaseContext(
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwFlags
);

매개 변수

[in] hProv

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

[in] dwFlags

나중에 사용할 수 있으며 0이어야 합니다. dwFlags가 0으로 설정되지 않은 경우 이 함수는 FALSE를 반환하지만 CSP가 해제됩니다.

반환 값

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

함수가 실패하면 반환 값은 0(FALSE)입니다. 확장된 오류 정보는 GetLastError를 호출합니다. 다음 표에는 몇 가지 가능한 오류 코드가 나열되어 있습니다.

반환 코드 설명
ERROR_BUSY
 hProv에 의해 지정된 CSP 컨텍스트는 현재 다른 프로세스에서 사용되고 있습니다.
ERROR_INVALID_HANDLE
 매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다.
ERROR_INVALID_PARAMETER
 매개 변수 중 하나에는 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다.
NTE_BAD_FLAGS
 dwFlags 매개 변수가 0이 아닌 경우
NTE_BAD_UID
 hProv 매개 변수에 유효한 컨텍스트 핸들이 없습니다.

설명

이 함수가 호출되면 CSP 세션이 완료되고 hProv 핸들을 사용하여 만든 모든 기존 세션 키 및 해시 개체가 더 이상 유효하지 않습니다. 실제로 CryptReleaseContext가 호출되기 전에 CryptDestroyKey 및 CryptDestroyHash를 호출하여 이러한 개체를 모두 제거해야 합니다.

예제

이 함수를 사용하는 예제는 예제 C 프로그램: 세션 키 만들기 및 해시를 참조하세요.

요구 사항

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

추가 정보

CryptAcquireContext

CryptDestroyHash

CryptDestroyKey

서비스 공급자 함수