BCryptCreateMultiHash 함수(bcrypt.h)

아티클
02/26/2024

BCryptCreateMultiHash 함수는 여러 해시 작업의 병렬 계산을 허용하는 다중 해시 상태를 만듭니다. 이 다중 해시 상태는 BCryptProcessMultiOperations 함수에서 사용됩니다. 다중 해시 상태는 각각 BCryptCreateHash에서 만든 해시 개체와 동일한 해시 개체의 배열로 간주할 수 있습니다.

병렬 계산은 개별 계산에 대한 대기 시간이 늘어나면 전체 처리량을 크게 늘릴 수 있습니다.

병렬 해시 계산은 현재 SHA-256, SHA-384 및 SHA-512에 대해서만 구현됩니다. 다른 해시 알고리즘은 병렬 계산 API와 함께 사용할 수 있지만 순차 해시 작업의 처리량에서 실행됩니다. 병렬 계산을 활용할 수 있는 해시 알고리즘 집합은 향후 업데이트에서 변경될 수 있습니다.

구문

NTSTATUS BCryptCreateMultiHash(
  BCRYPT_ALG_HANDLE  hAlgorithm,
  BCRYPT_HASH_HANDLE *phHash,
  ULONG              nHashes,
  PUCHAR             pbHashObject,
  ULONG              cbHashObject,
  PUCHAR             pbSecret,
  ULONG              cbSecret,
  ULONG              dwFlags
);

매개 변수

hAlgorithm

BCRYPT_ALG_HANDLE[in, out]

다중 해시 배열의 모든 해시 상태에 사용되는 알고리즘 핸들입니다. 알고리즘 핸들은 BCryptOpenAlgorithmProvider 함수에 전달된 BCYRPT_MULTI_FLAG 열어야 합니다. 또는 호출자가 의사 핸들을 사용할 수 있습니다.

phHash

BCRYPT_HASH_HANDLE* [out]

다중 해시 상태를 나타내는 핸들을 수신하는 BCRYPT_HASH_HANDLE 값에 대한 포인터입니다. 이 핸들은 BCryptProcessMultiOperations와 같은 후속 작업에서 사용됩니다. 이 핸들 사용을 마쳤으면 BCryptDestroyHash 함수에 전달하여 해제합니다.

nHashes

Ulong[in]

배열의 요소 수입니다. 이 함수가 만드는 다중 해시 상태는 nHashes 다른 해시 상태에서 병렬 계산을 수행할 수 있습니다.

pbHashObject

PUCHAR[out]

다중 해시 상태를 수신하는 버퍼에 대한 포인터입니다.

크기는 BCRYPT_MULTI_OBJECT_LENGTH_STRUCT 구조체의 cbPerObject 및 cbPerElement 멤버에서 계산할 수 있습니다. 값은 입니다 cbPerObject + (number of hash states) * cbPerElement.

pbHashObject가 이 NULL 고 cbHashObject 값이 0인0 경우 개체 버퍼가 자동으로 할당됩니다.

cbHashObject

Ulong[in]

pbHashObject 버퍼의 크기이거나 pbHashObject가 인 경우 0(0)입니다NULL.

pbSecret

PUCHAR[in]

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

배열의 모든 요소에 동일한 키가 사용됩니다.

cbSecret

Ulong[in]

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

dwFlags

Ulong[in]

함수의 동작을 수정하는 플래그입니다. 이 값은 0이거나 아래 값일 수 있습니다. 다중 해시 개체는 항상 다시 사용할 수 있으며 항상 BCRYPT_HASH_REUSABLE_FLAG 전달된 것처럼 동작합니다. 이 플래그는 일관성을 위해 여기에서 지원됩니다.

값	의미
BCRYPT_HASH_REUSABLE_FLAG	재사용 가능한 해시 개체를 만듭니다. 개체는 BCryptFinishHash를 호출한 직후에 새 해시 작업에 사용할 수 있습니다. 자세한 내용은 CNG를 사용하여 해시 만들기를 참조하세요.

반환 값

함수의 성공 또는 실패를 나타내는 상태 코드를 반환합니다. 메서드가 성공하면 를 반환 STATUS_SUCCESS합니다. 다른 NTSTATUS 값은 NTSTATUS 값을 참조하세요.

설명

내부적으로 병렬 해시 계산은 해시 알고리즘 및 사용 가능한 CPU 기능에 따라 한 번에 최대 8개의 병렬 계산과 함께 단일 명령 SIMD(다중 데이터) 명령을 사용하여 수행됩니다. 성능을 최대화하려면 호출자가 병렬로 처리할 수 있는 8개 이상의 계산을 제공하는 것이 좋습니다.

같지 않은 길이의 계산의 경우 더 많은 계산을 병렬로 제공하면 구현에서 CPU 레지스터 전체에서 계산을 더 잘 예약할 수 있습니다. 이는 처리량 이점을 제공할 수 있습니다. 최적의 처리량을 위해 호출자가 8~100개의 계산을 제공하는 것이 좋습니다. 모든 해시 계산의 길이가 동일한 경우에만 해당 범위에서 더 낮은 값을 선택합니다.

HMAC-MD2, HMAC-MD4 및 GMAC에는 다중 해시가 지원되지 않습니다.

요구 사항

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