BCryptHash 함수(bcrypt.h)

단일 해시 계산을 수행합니다. BCryptCreateHash, BCryptHashData, BCryptFinishHash 및 BCryptDestroyHash에 대한 호출을 래핑하는 편리한 함수입니다.

구문

NTSTATUS BCryptHash(
  BCRYPT_ALG_HANDLE hAlgorithm,
  PUCHAR            pbSecret,
  ULONG             cbSecret,
  PUCHAR            pbInput,
  ULONG             cbInput,
  PUCHAR            pbOutput,
  ULONG             cbOutput
);

매개 변수

hAlgorithm

BCryptOpenAlgorithmProvider 함수를 사용하여 만든 알고리즘 공급자의 핸들입니다. 공급자를 만들 때 지정된 알고리즘은 해시 인터페이스를 지원해야 합니다.

pbSecret

해시 또는 MAC에 사용할 키가 포함된 버퍼에 대한 포인터입니다. cbSecret 매개 변수에는 이 버퍼의 크기가 포함됩니다. 이 키는 BCRYPT_ALG_HANDLE_HMAC 플래그를 사용하여 BCryptOpenAlgorithmProvider 함수에서 연 해시 알고리즘에만 적용됩니다. 그렇지 않으면 이 매개 변수를 NULL로 설정합니다.

cbSecret

pbSecret 버퍼의 크기(바이트)입니다. 키가 사용되지 않는 경우 이 매개 변수를 0으로 설정합니다.

pbInput

처리할 데이터가 포함된 버퍼에 대한 포인터입니다. cbInput 매개 변수에는 이 버퍼의 바이트 수가 포함됩니다. 이 함수는 이 버퍼의 내용을 수정하지 않습니다.

cbInput

pbInput 버퍼의 바이트 수입니다.

pbOutput

해시 또는 MAC 값을 수신하는 버퍼에 대한 포인터입니다. cbOutput 매개 변수에는 이 버퍼의 크기가 포함됩니다.

cbOutput

pbOutput 버퍼의 크기(바이트)입니다. 이 크기는 해시 또는 MAC 값의 크기와 정확히 일치해야 합니다.

BCryptGetProperty 함수를 호출하여 BCRYPT_HASH_LENGTH 속성을 가져와 크기를 가져올 수 있습니다. 이렇게 하면 지정된 알고리즘에 대한 해시 또는 MAC 값의 크기가 표시됩니다.

반환 값

성공 또는 실패를 나타내는 상태 코드입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	bcrypt.h
라이브러리	Bcrypt.lib
DLL	Bcrypt.dll