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 |