Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
NCryptSetProperty con el proveedor de almacenamiento de claves (KSP)
La función NCryptSetProperty establece valores de propiedades para un objeto de almacenamiento de claves.
Parameters
-
hObject[entrada] -
El identificador del objeto cuya propiedad desea establecer. Puede usar:
-
Un identificador de proveedor (
NCRYPT_PROV_HANDLE) -
Un identificador de clave (
NCRYPT_KEY_HANDLE)
-
-
pszProperty[entrada] -
Un puntero a una cadena Unicode terminada en nulo que contiene el nombre de la propiedad que se va a recuperar.
Cuando se utiliza
NCRYPT_PROV_HANDLE, el proveedor de almacenamiento de AWS CloudHSM claves (KSP) admite los siguientes identificadores de KSP:Identificador/Valor Description (Descripción) NCRYPT_USE_CONTEXT_PROPERTY
L"Use Context"
Un puntero a una cadena Unicode terminada en nulo que describe el contexto de la operación.
Cuando se utiliza
NCRYPT_KEY_HANDLE, el proveedor de almacenamiento de AWS CloudHSM claves (KSP) admite los siguientes identificadores de KSP:Identificador/Valor Description (Descripción) NCRYPT_KEY_USAGE_PROPERTY
L"Key Usage"
Un DWORD que contiene un conjunto de indicadores que definen los detalles de uso de la clave. Esta propiedad solo se aplica a las claves. Puede contener cero o una combinación de uno o más de los siguientes valores.
NCRYPT_ALLOW_DECRYPT_FLAG (0x00000001)
NCRYPT_ALLOW_SIGNING_FLAG (0x00000002)
NCRYPT_LENGTH_PROPERTY
L"Length"
Un DWORD que contiene la longitud de la clave en bits.
NCRYPT_EXPORT_POLICY_PROPERTY
L"Export Policy"
Un DWORD que contiene indicadores que especifican la política de exportación de la clave persistente. Puede contener cero o una combinación de uno o más de los siguientes valores.
NCRYPT_ALLOW_EXPORT_FLAG (0x00000001)
nota
Los valores son literales de cadena de caracteres anchos, como lo indica la L antes del literal.
-
pbInput[entrada] -
La dirección de un búfer que contiene el nuevo valor de la propiedad.
cbInputcontiene el tamaño del búfer. -
cbInput[entrada] -
El tamaño del búfer
pbInputen bytes. dwFlags[entrada]-
Indicadores que modifican el comportamiento de la función. No se ha definido ningún indicador para esta función.
Valor de retorno
La función devuelve un código de estado para indicar si la operación se realizó correctamente o si se produjo un error.
Los códigos de retorno comunes incluyen:
| Código de retorno | Description (Descripción) |
|---|---|
|
ERROR_SUCCESS |
La operación se completó correctamente. |
|
NTE_INVALID_PARAMETER |
Uno o más parámetros no son válidos. |
|
NTE_FAIL |
La operación no se pudo completar. |
|
NTE_BAD_FLAGS |
El parámetro |
|
NTE_NOT_SUPPORTED |
El parámetro |
|
NTE_INVALID_HANDLE |
El identificador en |
|
NTE_BAD_DATA |
Los datos a los que apuntan |
