Función CryptCATCDFOpen (mscat.h)
[La función CryptCATCDFOpen está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.
Estructura CRYPTCATCDF . MakeCat llama a CryptCATCDFOpen.
Sintaxis
CRYPTCATCDF * CryptCATCDFOpen(
[in] LPWSTR pwszFilePath,
[in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
Parámetros
[in] pwszFilePath
Puntero a una cadena terminada en null que contiene la ruta de acceso del archivo CDF que se va a abrir.
[in, optional] pfnParseError
Puntero a una función definida por el usuario para controlar los errores de análisis de archivos.
Valor devuelto
Tras la operación correcta, esta función devuelve un puntero a la estructura CRYPTCATCDF recién creada. La función CryptCATCDFOpen devuelve un puntero NULL si se produce un error.
Comentarios
La función CryptCATCDFOpen usa los siguientes valores predeterminados para condiciones dadas en la sección CatalogHeader de CDF.
| Condición CatalogHeader | Valor predeterminado |
|---|---|
| No se especifica ningún valor name . | El nombre de archivo de pwszFilePath se usa para el archivo de salida del catálogo (.cat). |
| No se especifica ningún valor PublicVersion . | 0x00000001 |
| No se especifica ningún valor encodingType . | PKCS_7_ASN_ENCODING o X509_ASN_ENCODING (0x00010001) |
La función CryptCATCDFOpen realiza las siguientes acciones para condiciones de error dadas.
| Condición de error | Acción realizada |
|---|---|
| No se encuentran etiquetas CatalogHeader o Name en CDF. | Si especifica el autor de la llamada, la función CryptCATCDFOpen llama a la función especificada por pfnParseError y devuelve un puntero NULL . |
| La función CryptCATCDFOpen llama a la función CryptCATOpen para obtener un identificador para el archivo de salida del catálogo (.cat), pero obtiene un identificador NULL o no válido. | Llama a la función CryptCATCDFClose y devuelve un puntero NULL . |
| Identificadores de acceso adicionales para la rama Catálogo | Definición |
|---|---|
| szOID_CATALOG_LIST_MEMBER_V2 | 1.3.6.1.4.1.311.12.1.3 |
| CAT_MEMBERINFO2_OBJID | 1.3.6.1.4.1.311.12.2.3 |
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Los OID de catálogo adicionales no están disponibles.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mscat.h |
| Archivo DLL | Wintrust.dll |