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.
NCryptGetPropertycon proveedor de almacenamiento de claves (KSP)
La NCryptGetProperty función recupera los valores de las propiedades de un objeto de almacenamiento clave.
Parámetros
-
hObject[en] -
El identificador del objeto cuya propiedad desea recuperar. Puede usar:
-
Un identificador de proveedor (
NCRYPT_PROV_HANDLE) -
Un identificador de llave (
NCRYPT_KEY_HANDLE)
-
-
pszProperty[en] -
Un puntero a una cadena Unicode terminada en cero que contiene el nombre de la propiedad que se va a recuperar.
Cuando se usa
NCRYPT_PROV_HANDLE, AWS CloudHSM Key Storage Provider (KSP) admite los siguientes identificadores: KSPIdentificador/valor Descripción NCRYPT_IMPL_TYPE_PROPERTY
«Tipo de Limpl»
A DWORD contiene indicadores que definen los detalles de implementación del proveedor
NCRYPT_MAX_NAME_LENGTH_PROPERTY
L «Longitud máxima del nombre»
A DWORD contiene la longitud máxima (en caracteres) de un nombre de clave persistente.
NCRYPT_NAME_PROPERTY
L «Nombre»
Un puntero a una cadena Unicode terminada en cero que contiene el nombre. KSP
NCRYPT_VERSION_PROPERTY
La «Versión»
A DWORD contiene la versión del proveedor (palabra alta: versión principal, palabra baja: versión secundaria).
NCRYPT_USE_CONTEXT_PROPERTY
«Usa el contexto»
Un puntero a una cadena Unicode terminada en cero que describe el contexto de la operación.
NCRYPT_SECURITY_DESCR_SUPPORT_PROPERTY
El «Security Descr Support»
Indica si el proveedor admite descriptores de seguridad para las claves.
Cuando se utiliza
NCRYPT_KEY_HANDLE, AWS CloudHSM Key Storage Provider (KSP) admite los siguientes KSP identificadores:Identificador/valor Descripción NCRYPT_ALGORITHM_PROPERTY
L «Nombre del algoritmo»
Cadena Unicode terminada en cero que contiene el nombre del algoritmo de la clave.
NCRYPT_BLOCK_LENGTH_PROPERTY
L «Longitud de bloque»
A DWORD contiene la longitud del bloque de cifrado en bytes.
NCRYPT_EXPORT_POLICY_PROPERTY
L «Política de exportación»
A DWORD contiene indicadores que especifican la política de exportación de la clave persistente.
NCRYPT_KEY_USAGE_PROPERTY
«Uso de la clave L»
A DWORD contiene indicadores que definen los detalles de uso clave.
NCRYPT_KEY_TYPE_PROPERTY
«Tipo de clave»
A DWORD contiene indicadores que definen el tipo de clave.
NCRYPT_LENGTH_PROPERTY
L «Longitud»
A DWORD que contiene la longitud de la clave en bits.
NCRYPT_LENGTHS_PROPERTY
L «Longitudes»
Un puntero a una LENGTHS estructura NCRYPT _ SUPPORTED _ que contiene los tamaños de clave compatibles.
NCRYPT_NAME_PROPERTY
L «Nombre»
Un puntero a una cadena Unicode terminada en cero que contiene el nombre de la clave.
NCRYPT_SECURITY_DESCR_PROPERTY
«Descripción de seguridad»
Un puntero a una DESCRIPTOR estructura SECURITY _ que contiene información clave de control de acceso.
NCRYPT_ALGORITHM_GROUP_PROPERTY
L «Grupo de algoritmos»
Cadena Unicode terminada en cero que contiene el nombre del grupo de algoritmos del objeto.
NCRYPT_UNIQUE_NAME_PROPERTY
L «Nombre único»
Un puntero a una cadena Unicode terminada en cero que contiene el nombre único de la clave.
nota
Los valores son literales de cadena de caracteres anchos, como se indica con L antes del literal.
-
pbOutput[fuera] -
La dirección de un búfer para almacenar el valor de la propiedad. Especifique el tamaño del búfer utilizando
cbOutput.Para determinar el tamaño de búfer requerido, defina este parámetro enNULL. La función almacena el tamaño requerido (en bytes) en la ubicación indicada por
pcbResult. -
cbOutput[en] -
El tamaño del
pbOutputbúfer en bytes. pcbResult[fuera]-
Un puntero a una DWORD variable que almacena el número de bytes copiados en el
pbOutputbúfer.Si
pbOutputes asíNULL, almacena el tamaño requerido (en bytes). dwFlags[en]-
Banderas para modificar el comportamiento de la función. Puede usar cero o:
Valor Significado NCRYPT_SILENT_FLAG
Esta bandera no tiene ningún efecto.
Cuando pszProperty lo esté
NCRYPT_SECURITY_DESCR_PROPERTY, utilice uno o una combinación de:Valor Significado OWNER_SECURITY_INFORMATION
Esta bandera no tiene ningún efecto.
GROUP_SECURITY_INFORMATION
Esta bandera no tiene ningún efecto.
DACL_SECURITY_INFORMATION
Esta bandera no tiene ningún efecto.
LABEL_SECURITY_INFORMATION
Esta bandera no tiene ningún efecto.
SACL_SECURITY_INFORMATION
Esta bandera no tiene ningún efecto.
Valor de retorno
La función devuelve un código de estado para indicar el éxito o el fracaso.
Los códigos de devolución más comunes incluyen:
| Código de retorno | Descripción |
|---|---|
|
ERROR_SUCCESS |
La operación se completó satisfactoriamente. |
|
NTE_INVALID_PARAMETER |
Uno o más parámetros no son válidos. |
|
NTE_FAIL |
No se ha podido completar la operación. |
|
NTE_BAD_FLAGS |
El |
|
NTE_NOT_SUPPORTED |
El |
|
NTE_INVALID_HANDLE |
El identificador no |
|
NTE_BUFFER_TOO_SMALL |
El |
