本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# NCryptSetProperty 使用密钥存储提供商 (KSP)
<a name="ksp-library-apis-set-property"></a>

`NCryptSetProperty` 函数设置密钥存储对象的属性值。

## 参数
<a name="ksp-library-apis-create-set-property-parameters"></a>

 `hObject` [in]   
 要设置其属性的对象的句柄。您可以使用：  
+ 提供程序句柄（`NCRYPT_PROV_HANDLE`）
+ 密钥句柄（`NCRYPT_KEY_HANDLE`）

 `pszProperty ` [in]   
指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要检索的属性名称。  
使用时`NCRYPT_PROV_HANDLE`， AWS CloudHSM 密钥存储提供程序 (KSP) 支持以下 KSP 标识符：    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/cloudhsm/latest/userguide/ksp-library-apis-set-property.html)
使用时`NCRYPT_KEY_HANDLE`， AWS CloudHSM 密钥存储提供程序 (KSP) 支持以下 KSP 标识符：    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/cloudhsm/latest/userguide/ksp-library-apis-set-property.html)
值是宽字符字符串文字，如文字前的 L 所示。

 `pbInput` [in]   
 包含新属性值的缓冲区的地址。`cbInput` 包含缓冲区的大小。

 `cbInput` [in]   
 `pbInput` 缓冲区的大小，以字节为单位。

`dwFlags` [in]  
修改函数行为的标志。没有为此函数定义任何标志。

## 返回值
<a name="ksp-library-apis-set-property-return-value"></a>

该函数返回一个状态代码，指示成功或失败。

常见的返回代码包括：


****  

| 返回代码 | 说明 | 
| --- | --- | 
| ERROR\_SUCCESS | 操作已成功完成。 | 
| NTE\_INVALID\_PARAMETER | 一个或多个参数无效。 | 
| NTE\_FAIL | 操作无法完成。 | 
| NTE\_BAD\_FLAGS | `dwFlags` 参数包含无效值。 | 
| NTE\_NOT\_SUPPORTED | `pszProperty` 参数包含不支持的值。 | 
| NTE\_INVALID\_HANDLE | `hObject` 中的句柄无效。 | 
| NTE\_BAD\_DATA | `pbInput` 和 `cbInput` 所指向的数据无效。 |