CryptSetHashParam 함수(wincrypt.h)

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

CryptSetHashParam 함수는 초기 해시 콘텐츠 설정 및 특정 해시 알고리즘 선택을 포함하여 해시 개체의 작업을 사용자 지정합니다.

구문

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

[in] hHash

매개 변수를 설정할 해시 개체에 대한 핸들입니다.

[in] dwParam

이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
HP_HMAC_INFO.	암호화 해시 알고리즘과 사용할 내부 및 외부 문자열을 지정하는 HMAC_INFO 구조체에 대한 포인터입니다.
HP_HASHVAL.	해시 개체에 직접 배치할 해시 값을 포함하는 바이트 배열입니다. 이 값을 설정하기 전에 CryptGetHashParam 함수를 사용하여 해시 값의 크기를 결정하여 HP_HASHSIZE 값을 읽어야 합니다. 일부 CSP( 암호화 서비스 공급자 )는 이 기능을 지원하지 않습니다.

참고 일부 CSP 형식은 이 함수를 사용하여 설정할 수 있는 추가 값을 추가할 수 있습니다.

[in] pbData

값 데이터 버퍼입니다. CryptSetHashParam을 호출하기 전에 이 버퍼에 값 데이터를 배치합니다. 이 데이터의 형식은 값 번호에 따라 달라집니다.

[in] dwFlags

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정해야 합니다.

함수가 성공하면 함수는 TRUE를 반환 합니다.

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

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

반환 코드	설명
ERROR_INVALID_HANDLE	매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다.
ERROR_BUSY	CSP 컨텍스트는 현재 다른 프로세스에서 사용되고 있습니다.
ERROR_INVALID_PARAMETER	매개 변수 중 하나에 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다.
NTE_BAD_FLAGS	dwFlags 매개 변수가 0이 아니거나 pbData 버퍼에 유효하지 않은 값이 포함되어 있습니다.
NTE_BAD_HASH	hHash 매개 변수로 지정된 해시 개체가 잘못되었습니다.
NTE_BAD_TYPE	dwParam 매개 변수는 알 수 없는 값을 지정합니다.
NTE_BAD_UID	hKey 키를 만들 때 지정된 CSP 컨텍스트를 찾을 수 없습니다.
NTE_FAIL	함수가 예기치 않은 방식으로 실패했습니다.

경우에 따라 다른 곳에서 생성된 해시 값에 서명해야 합니다. 이 작업은 다음 작업 시퀀스를 사용하여 수행할 수 있습니다.