Función CertSaveStore (wincrypt.h)
La función CertSaveStore guarda el almacén de certificados en un archivo o en un BLOB de memoria.
Sintaxis
BOOL CertSaveStore(
[in] HCERTSTORE hCertStore,
[in] DWORD dwEncodingType,
[in] DWORD dwSaveAs,
[in] DWORD dwSaveTo,
[in, out] void *pvSaveToPara,
[in] DWORD dwFlags
);
Parámetros
[in] hCertStore
Identificador del almacén de certificados que se va a guardar.
[in] dwEncodingType
Especifica el tipo de codificación de certificado y el tipo de codificación de mensajes. La codificación solo se usa cuando dwSaveAs contiene CERT_STORE_SAVE_AS_PKCS7. De lo contrario, no se usa el parámetro dwMsgAndCertEncodingType .
Este parámetro puede ser una combinación de uno o varios de los valores siguientes.
| Valor | Significado |
|---|---|
|
Especifica la codificación de mensajes PKCS 7. |
|
Especifica la codificación de certificados X.509. |
[in] dwSaveAs
Especifica cómo guardar el almacén de certificados.
Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
El almacén de certificados se puede guardar como un mensaje firmado PKCS #7 que no incluye propiedades adicionales. El parámetro dwEncodingType especifica el tipo de codificación de mensajes. |
|
El almacén de certificados se puede guardar como un almacén serializado que contiene propiedades, además de certificados codificados, listas de revocación de certificados (CRL) y listas de confianza de certificados (CTL). Se omite el parámetro dwEncodingType .
Nota La propiedad CERT_KEY_CONTEXT_PROP_ID y los valores de CERT_KEY_PROV_HANDLE_PROP_ID y CERT_KEY_SPEC_PROP_ID relacionados no se guardan en un almacén serializado.
|
[in] dwSaveTo
Especifica dónde y cómo guardar el almacén de certificados. El contenido de este parámetro determina el formato del parámetro pvSaveToPara .
Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
La función guarda el almacén de certificados en un archivo. El parámetro pvSaveToPara contiene un identificador para un archivo obtenido anteriormente mediante la función CreateFile . El archivo debe abrirse con permiso de escritura. Después de una operación de guardado correcta, el puntero de archivo se coloca después de la última operación de escritura. |
|
La función guarda el almacén de certificados en un archivo. El parámetro pvSaveToPara contiene un puntero a una cadena Unicode terminada en null que contiene la ruta de acceso y el nombre de archivo del archivo en el que se va a guardar. La función abre el archivo, lo guarda y lo cierra. |
|
La función guarda el almacén de certificados en un archivo. El parámetro pvSaveToPara contiene un puntero a una cadena ANSI terminada en null que contiene la ruta de acceso y el nombre de archivo del archivo en el que se va a guardar. La función abre el archivo, lo guarda y lo cierra. |
|
La función guarda el almacén de certificados en un archivo. El parámetro pvSaveToPara contiene un puntero a una cadena Unicode terminada en null que contiene la ruta de acceso y el nombre de archivo del archivo en el que se va a guardar. La función abre el archivo, lo guarda y lo cierra. |
|
La función guarda el almacén de certificados en un BLOB de memoria. El parámetro pvSaveToPara contiene un puntero a una estructura CERT_BLOB . Antes de su uso, se deben inicializar los miembros pbData y cbData de la CERT_BLOB. Tras la devolución, cbData se actualiza con la longitud real. Para un cálculo de solo longitud, pbData debe establecerse en NULL. Si pbData no es NULL y cbData no es lo suficientemente grande, la función devuelve cero con un último código de error de ERROR_MORE_DATA. |
[in, out] pvSaveToPara
Puntero que representa dónde se debe guardar el almacén. El contenido de este parámetro depende del valor del parámetro dwSaveTo .
[in] dwFlags
Este parámetro está reservado para uso futuro y debe establecerse en cero.
Valor devuelto
Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.
Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.
Tenga en cuenta que los errores CreateFile o WriteFile se pueden propagar a esta función. Un código de error posible es CRYPT_E_FILE_ERROR que indica que se produjo un error al escribir en el archivo.
Requisitos
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | wincrypt.h |
| Library | Crypt32.lib |
| Archivo DLL | Crypt32.dll |