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

해시 및 디지털 서명 함수