CryptHashData 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 암호화 차세대 API 사용을 시작해야 합니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptHashData 함수는 지정된 해시 개체에 데이터를 추가합니다. 이 함수와 CryptHashSessionKey 는 길고 불연속적인 데이터 스트림의 해시를 계산하기 위해 여러 번 호출할 수 있습니다.

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

구문

BOOL CryptHashData(
  [in] HCRYPTHASH hHash,
  [in] const BYTE *pbData,
  [in] DWORD      dwDataLen,
  [in] DWORD      dwFlags
);

매개 변수

[in] hHash

해시 개체의 핸들입니다.

[in] pbData

해시 개체에 추가할 데이터가 포함된 버퍼에 대한 포인터입니다.

[in] dwDataLen

추가할 데이터 바이트 수입니다. CRYPT_USERDATA 플래그가 설정된 경우 0이어야 합니다.

[in] dwFlags

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

값 의미
CRYPT_OWF_REPL_LM_HASH
0x00000001
 이 플래그는 사용되지 않습니다.
CRYPT_USERDATA
1(0x1)
 모든 Microsoft 암호화 공급자는 이 매개 변수를 무시합니다. 이 매개 변수를 무시하지 않는 CSP의 경우 이 플래그가 설정된 경우 CSP는 사용자에게 직접 데이터를 입력하라는 메시지를 표시합니다. 이 데이터는 해시에 추가됩니다. 애플리케이션은 데이터에 액세스할 수 없습니다. 이 플래그를 사용하여 사용자가 시스템에 PIN을 입력할 수 있습니다.

반환 값

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

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

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

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

요구 사항

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

추가 정보

CryptCreateHash

CryptHashSessionKey

CryptSignHash

해시 및 디지털 서명 함수