Compartir a través de

Método ICertSrvSetup::CAImportPFX (casetup.h)

  • Artículo

El método CAImportPFX importa un certificado de entidad de certificación (CA) y su clave privada asociada en el almacén de equipos local. Este método no cambia el estado del objeto CCertSrvSetup .

Sintaxis

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

Parámetros

[in] bstrFileName

Cadena que contiene el nombre de un archivo PFX usado para importar una clave privada.

[in] bstrPasswd

Cadena que contiene una contraseña para el archivo PFX.

[in] bOverwriteExistingKey

Valor que indica si se va a sobrescribir una clave existente del mismo nombre.

[out] ppVal

Dirección de un puntero a una interfaz ICertSrvSetupKeyInformation que se puede usar para establecer propiedades de la clave privada importada.

Valor devuelto

None

Observaciones

El método CAImportPFX usa los parámetros de entrada para descifrar y descodificar un archivo PFX y, a continuación, instala la clave y el certificado en el almacén del equipo local. Si el certificado cumple los siguientes criterios y después de la instalación de la clave, el método devuelve un objeto ICertSrvSetupKeyInformation al autor de la llamada.

  • Contiene una clave AT_SIGNATURE que coincide con la clave en el contenedor de claves privadas.
  • Está autofirmado o tiene restricciones básicas para una ENTIDAD de certificación.
  • Pasa la validación de la cadena, pero podría tener un error de revocación sin conexión.
Si el archivo PFX contiene varios certificados y claves, CAImportPFX instala todos los certificados y claves; sin embargo, el objeto ICertSrvSetupKeyInformation devuelto solo contiene propiedades del último certificado de CA en el archivo. Cuando el autor de la llamada termina de usar el objeto ICertSrvSetupKeyInformation , el autor de la llamada debe liberarlo mediante el método Release .

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado casetup.h
Archivo DLL Certocm.dll

Consulte también

ICertSrvSetup