기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# KSP(Key Storage Provider)를 사용하는 NCryptSignHash
<a name="ksp-library-apis-sign-hash"></a>

`NCryptSignHash` 함수는 해시 값의 서명을 생성합니다.

## Parameters
<a name="ksp-library-apis-sign-hash-parameters"></a>

 `hKey` [in]   
 해시 서명에 사용할 키의 핸들입니다.

`pPaddingInfo` [in, 선택 사항]  
패딩 정보가 포함된 구조에 대한 포인터입니다. 구조 유형은 `dwFlags` 값에 따라 다릅니다. 이 파라미터는 비대칭 키에만 사용하고 다른 키 유형에는 NULL로 설정합니다.

`pbHashValue` [in]  
서명할 해시 값을 포함하는 버퍼에 대한 포인터입니다. `cbHashValue`를 사용하여 버퍼 크기를 지정합니다.

`cbHashValue` [in]  
서명할 `pbHashValue` 버퍼의 크기(바이트)입니다.

`pbSignature` [out]  
서명을 저장할 버퍼의 주소입니다. `cbSignature`를 사용하여 버퍼 크기를 지정합니다.  
필요한 버퍼 크기를 확인하려면 이 파라미터를 NULL로 설정합니다. 함수는 `pcbResult`가 가리키는 위치에 필요한 크기(바이트)를 저장합니다.

`cbSignature` [in]  
바이트 단위의 `pbSignature` 버퍼 크기입니다. `pbSignature`가 NULL인 경우 함수는 이 파라미터를 무시합니다.

`pcbResult` [out]  
`pbSignature` 버퍼에 복사된 바이트 수를 저장하는 DWORD 변수에 대한 포인터입니다.  
`pbSignature`가 NULL이면 필요한 버퍼 크기가 바이트 단위로 저장됩니다.

`dwFlags` [in]  
함수의 동작을 수정하는 플래그입니다. 허용되는 플래그는 키 유형에 따라 다릅니다. 다음 값 중 하나를 사용합니다.    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/cloudhsm/latest/userguide/ksp-library-apis-sign-hash.html)

## 반환 값
<a name="ksp-library-apis-sign-hash-return-value"></a>

이 함수는 성공 또는 실패를 나타내는 상태 코드를 반환합니다.

일반적인 반환 코드는 다음과 같습니다.


****  

| 반환 코드 | 설명 | 
| --- | --- | 
| ERROR\_SUCCESS | 작업이 성공적으로 완료되었습니다. | 
| NTE\_INVALID\_PARAMETER | 하나 이상의 파라미터가 유효하지 않습니다. | 
| NTE\_FAIL | 작업을 완료할 수 없습니다. | 
| NTE\_INVALID\_HANDLE | `hKey`의 핸들이 유효하지 않습니다. | 
| NTE\_BAD\_FLAGS | `dwFlags` 파라미터에 유효하지 않은 값이 있습니다. | 
| NTE\_BUFFER\_TOO\_SMALL | `pcbOutput` 파라미터가 반환 값에 비해 너무 작습니다. | 
| NTE\_BAD\_KEY\_STATE | 키 상태가 유효하지 않습니다. | 
| NTE\_INTERNAL\_ERROR | 해시 서명 시 내부 오류가 발생했습니다. |