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

# KSP(Key Storage Provider)를 사용하는 NCryptGetProperty
<a name="ksp-library-apis-get-property"></a>

`NCryptGetProperty` 함수는 키 스토리지 객체의 속성 값을 검색합니다.

## Parameters
<a name="ksp-library-apis-create-get-property-parameters"></a>

 `hObject` [in]   
 속성을 검색하려는 객체의 핸들입니다. 다음을 사용할 수 있습니다.  
+ 공급자 핸들(`NCRYPT_PROV_HANDLE`)
+ 키 핸들(`NCRYPT_KEY_HANDLE`)

 `pszProperty ` [in]   
검색할 속성 이름을 포함하는 Null로 종료된 유니코드 문자열에 대한 포인터입니다.  
`NCRYPT_PROV_HANDLE`를 사용하는 경우 AWS CloudHSM Key Storage Provider(KSP)는 다음 KSP 식별자를 지원합니다.    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
`NCRYPT_KEY_HANDLE`를 사용하는 경우 AWS CloudHSM Key Storage Provider(KSP)는 다음 KSP 식별자를 지원합니다.    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
값은 리터럴 앞에 L로 표시된 와이드 문자 문자열 리터럴입니다.

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

 `cbOutput` [in]   
 바이트 단위의 `pbOutput` 버퍼 크기입니다.

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

`dwFlags` [in]  
함수의 동작을 수정하는 플래그입니다. 0 또는 다음을 사용할 수 있습니다.    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
pszProperty가 `NCRYPT_SECURITY_DESCR_PROPERTY`인 경우 다음 중 하나 또는 다음의 조합을 사용합니다.    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)

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

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

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


****  

| 반환 코드 | 설명 | 
| --- | --- | 
| ERROR\_SUCCESS | 작업이 성공적으로 완료되었습니다. | 
| NTE\_INVALID\_PARAMETER | 하나 이상의 파라미터가 유효하지 않습니다. | 
| NTE\_FAIL | 작업을 완료할 수 없습니다. | 
| NTE\_BAD\_FLAGS | `dwFlags` 파라미터에 유효하지 않은 값이 있습니다. | 
| NTE\_NOT\_SUPPORTED | `pszAlgId` 파라미터에는 지원되지 않는 값이 포함되어 있습니다. | 
| NTE\_INVALID\_HANDLE | `hObject`의 핸들이 유효하지 않습니다. | 
| NTE\_BUFFER\_TOO\_SMALL | `cbOutput` 파라미터가 반환 값에 비해 너무 작습니다. |