Compartir a través de


Función CertAddEncodedCertificateToSystemStoreW (wincrypt.h)

La función CertAddEncodedCertificateToSystemStore abre el almacén del sistema especificado y agrega el certificado codificado.

Sintaxis

BOOL CertAddEncodedCertificateToSystemStoreW(
  [in] LPCWSTR    szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Parámetros

[in] szCertStoreName

Cadena terminada en NULL que contiene el nombre del almacén del sistema para el certificado codificado.

[in] pbCertEncoded

Puntero a un búfer que contiene el certificado codificado que se va a agregar.

[in] cbCertEncoded

Tamaño, en bytes, del búfer de pbCertEncoded de .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. CertAddEncodedCertificateToSystemStore depende de las funciones enumeradas en los siguientes comentarios para el control de errores. Consulte esos temas de función para conocer sus respectivos comportamientos de control de errores. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Internamente, CertAddEncodedCertificateToSystemStore llama a CertOpenSystemStore y certAddEncodedCertificateToStore con los parámetros siguientes.

Parámetro CertOpenSystemStore de Valor
szSubsystemProtocol szCertStoreName
 

Si CertAddEncodedCertificateToSystemStore obtiene un identificador para el almacén del sistema especificado, llama a CertCloseStore para cerrar el identificador antes de que se devuelva.

parámetro CertAddEncodedCertificateToStore Valor
dwCertEncodingType X509_ASN_ENCODING
dwAddDisposition CERT_STORE_ADD_USE_EXISTING
ppCertContext NULL
 

Nota

El encabezado wincrypt.h define CertAddEncodedCertificateToSystemStore como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wincrypt.h
biblioteca de Crypt32.lib
DLL de Crypt32.dll