BCryptCreateMultiHash 함수(bcrypt.h)
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 |