Share via

CryptHashSessionKey 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 암호화 차세대 API 사용을 시작해야 합니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptHashSessionKey 함수는 세션 키 개체의 암호화 해시를 계산합니다. 이 함수는 동일한 해시 핸들을 사용하여 여러 키의 해시 를 계산하여 여러 번 호출할 수 있습니다. CryptHashSessionKey에 대한 호출은 CryptHashData 호출과 함께 산재할 수 있습니다.

이 함수를 호출하기 전에 CryptCreateHash 를 호출하여 해시 개체의 핸들을 만들어야 합니다.

구문

BOOL CryptHashSessionKey(
  [in] HCRYPTHASH hHash,
  [in] HCRYPTKEY  hKey,
  [in] DWORD      dwFlags
);

매개 변수

[in] hHash

해시 개체에 대한 핸들입니다.

[in] hKey

해시할 키 개체에 대한 핸들입니다.

[in] dwFlags

다음 플래그 값이 정의됩니다.

값 의미
CRYPT_LITTLE_ENDIAN
0x00000001
 이 플래그를 설정하면 키의 바이트가 little-endian 형식으로 해시됩니다. 기본적으로( dwFlags 가 0인 경우) 키의 바이트는 big-endian 형식으로 해시됩니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

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

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

반환 코드 설명
ERROR_INVALID_HANDLE
 매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다.
ERROR_INVALID_PARAMETER
 매개 변수 중 하나에는 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다.
NTE_BAD_ALGID
 hHash 핸들은 이 CSP가 지원하지 않는 알고리즘을 지정합니다.
NTE_BAD_FLAGS
 dwFlags 매개 변수가 0이 아닌 경우
NTE_BAD_HASH
 hHash 매개 변수로 지정된 해시 개체가 잘못되었습니다.
NTE_BAD_HASH_STATE
 이미 "완료됨"으로 표시된 해시 개체에 데이터를 추가하려고 했습니다.
NTE_BAD_KEY
 키 해시 알고리즘이 사용되고 있지만 세션 키가 더 이상 유효하지 않습니다. 이 오류는 해싱 작업이 완료되기 전에 세션 키가 제거되면 생성됩니다.
NTE_BAD_UID
 해시 개체를 만들 때 지정한 CSP 컨텍스트를 찾을 수 없습니다.
NTE_FAIL
 함수가 예기치 않은 방식으로 실패했습니다.

요구 사항

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

추가 정보

CryptCreateHash

CryptGenKey

CryptHashData

해시 및 디지털 서명 함수