Método IX509PrivateKey::Create (certenroll.h)

  • Artículo

El método Create crea una clave privada asimétrica.

Sintaxis

HRESULT Create();

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
HRESULT_FROM_WIN32(ERROR_BUSY)
 El identificador de CSP no es NULL.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)
 La clave ya existe.

Comentarios

Si no establece las propiedades CspStatus, ProviderName o ProviderType, este método usa los valores predeterminados de proveedor, tamaño de clave y KeySpec al crear la clave. En una nueva instalación del sistema operativo, por ejemplo, el proveedor criptográfico mejorado de Microsoft v1.0 es el proveedor predeterminado.

Si no establece la propiedad ContainerName , este método genera automáticamente un nombre. El nombre generado incluye un GUID y, si no se establece la propiedad ContainerNamePrefix, un prefijo de "lp-". Si el proveedor es un proveedor de tarjetas inteligentes, el nombre generado no superará el valor MaxKeyContainerNameLength especificado por el proveedor. Si el nombre generado supera inicialmente este valor, se trunca a cuarenta caracteres.

No se pueden establecer las siguientes propiedades después de llamar a los métodos Create o Open . Si desea especificarlos, debe hacerlo antes de llamar a cualquiera de estos métodos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

IX509PrivateKey