CryptGetHashParam 함수(wincrypt.h)

아티클
03/15/2023

중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 Cryptography Next Generation API 사용을 시작해야 합니다. Microsoft는 향후 릴리스에서 이 API를 제거할 수 있습니다.

CryptGetHashParam 함수는 해시 개체의 작업을 제어하는 데이터를 검색합니다. 이 함수를 사용하여 실제 해시 값을 검색할 수 있습니다.

구문

BOOL CryptGetHashParam(
  [in]      HCRYPTHASH hHash,
  [in]      DWORD      dwParam,
  [out]     BYTE       *pbData,
  [in, out] DWORD      *pdwDataLen,
  [in]      DWORD      dwFlags
);

매개 변수

[in] hHash

쿼리할 해시 개체의 핸들입니다.

[in] dwParam

쿼리 유형입니다. 이 매개 변수는 다음 쿼리 중 하나로 설정할 수 있습니다.

값	의미
HP_ALGID 해시 알고리즘	해시 개체를 만들 때 지정된 알고리즘을 나타내는 ALG_ID . 해시 알고리즘 목록은 CryptCreateHash를 참조하세요.
HP_HASHSIZE 해시 값 크기	해시 값의 바이트 수를 나타내는 DWORD 값입니다. 이 값은 해시 알고리즘에 따라 달라집니다. 애플리케이션은 올바른 양의 메모리를 할당할 수 있도록 HP_HASHVAL 값 바로 앞에 이 값을 검색해야 합니다.
HP_HASHVAL 해시 값	hHash로 지정된 해시 개체의 해시 값 또는 메시지 해시입니다. 이 값은 CryptHashData 및 CryptHashSessionKey 함수를 통해 이전에 해시 개체에 제공된 데이터를 기반으로 생성됩니다. CryptGetHashParam 함수는 해시를 완료합니다. CryptGetHashParam이 호출된 후에는 해시에 더 이상 데이터를 추가할 수 없습니다. CryptHashData 또는 CryptHashSessionKey에 대한 추가 호출이 실패합니다. 해시를 사용하여 애플리케이션을 완료한 후 CryptDestroyHash 를 호출하여 해시 개체를 삭제해야 합니다.

참고 CSP는 이 함수가 쿼리할 수 있는 값을 더 추가할 수 있습니다.

[out] pbData

지정된 값 데이터를 수신하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 값 번호에 따라 달라집니다.

이 매개 변수는 필요한 메모리 크기를 결정하는 NULL 일 수 있습니다.

[in, out] pdwDataLen

pbData 버퍼의 크기(바이트)를 지정하는 DWORD 값에 대한 포인터입니다. 함수가 반환되면 DWORD 값에는 버퍼에 저장된 바이트 수가 포함됩니다.

pbData가 NULL인 경우 pdwDataLen 값을 0으로 설정합니다.

참고 버퍼에서 반환된 데이터를 처리할 때 애플리케이션은 반환된 데이터의 실제 크기를 사용해야 합니다. 실제 크기는 입력에 지정된 버퍼의 크기보다 약간 작을 수 있습니다. (입력에서 버퍼 크기는 일반적으로 가능한 가장 큰 출력 데이터가 버퍼에 맞도록 충분히 크게 지정됩니다.) 출력에서 이 매개 변수가 가리키는 변수는 버퍼에 복사된 데이터의 실제 크기를 반영하도록 업데이트됩니다.

[in] dwFlags

나중에 사용하도록 예약되며 0이어야 합니다.

반환 값

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

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

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

반환 코드	설명
ERROR_INVALID_HANDLE	매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다.
ERROR_INVALID_PARAMETER	매개 변수 중 하나에 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다.
ERROR_MORE_DATA	pbData 매개 변수로 지정된 버퍼가 반환된 데이터를 저장할 만큼 크지 않은 경우 함수는 ERROR_MORE_DATA 코드를 설정하고 pdwDataLen이 가리키는 변수에 필요한 버퍼 크기를 바이트 단위로 저장합니다.
NTE_BAD_FLAGS	dwFlags 매개 변수가 0이 아닌 경우
NTE_BAD_HASH	hHash 매개 변수로 지정된 해시 개체가 잘못되었습니다.
NTE_BAD_TYPE	dwParam 매개 변수는 알 수 없는 값 번호를 지정합니다.
NTE_BAD_UID	해시를 만들 때 지정된 CSP 컨텍스트를 찾을 수 없습니다.

요구 사항


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