Función CryptCATAdminAddCatalog (mscat.h)

  • Artículo

[La función CryptCATAdminAddCatalog está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función CryptCATAdminAddCatalog agrega un catálogo a la base de datos del catálogo. La base de datos de catálogo es un índice que asocia hashes de archivo a los catálogos que los contienen. Se usa para acelerar la identificación de los catálogos al comprobar la firma del archivo. Esta función es la única manera admitida de agregar catálogos a la base de datos del catálogo de Windows mediante programación. La función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Wintrust.dll.

Sintaxis

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

Parámetros

[in] hCatAdmin

Controle previamente asignado por la función CryptCATAdminAcquireContext .

[in] pwszCatalogFile

Puntero a una cadena terminada en null para la ruta de acceso completa del catálogo que se va a agregar.

[in] pwszSelectBaseName

Puntero a una cadena terminada en null para el nombre del catálogo cuando se almacena. Si el parámetro es NULL, se generará un nombre único para el catálogo.

[in] dwFlags

Si se especifica la marca CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001), el catálogo especificado en la llamada se vinculará de forma difícil a en lugar de copiarse. La vinculación dura en lugar de copiar un catálogo reduce la cantidad de espacio en disco necesario para Windows.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador para el contexto de información del catálogo. Si la función no se realiza correctamente, el valor devuelto es NULL. Una vez que haya terminado de usar el identificador devuelto, libere el identificador llamando a la función CryptCATAdminReleaseCatalogContext .

Para obtener información de error extendida, llame a la función GetLastError . Para obtener una lista completa de los códigos de error proporcionados por el sistema operativo, consulte Códigos de error del sistema.

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
Library Wintrust.lib
Archivo DLL Wintrust.dll

Consulte también

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext