Función CryptCATAdminEnumCatalogFromHash (mscat.h)

[La función CryptCATAdminEnumCatalogFromHash 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 CryptCATAdminEnumCatalogFromHash enumera los catálogos que contienen un hash especificado. Normalmente, el hash se devuelve de la función CryptCATAdminCalcHashFromFileHandle . Después de la llamada final a esta función, llame a CryptCATAdminReleaseCatalogContext para liberar la memoria asignada.

Sintaxis

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

Parámetros

[in] hCatAdmin

Identificador de un contexto de administrador de catálogo asignado previamente por la función CryptCATAdminAcquireContext .

[in] pbHash

Puntero al búfer que contiene el hash recuperado mediante una llamada a CryptCATAdminCalcHashFromFileHandle.

[in] cbHash

Número de bytes en el búfer asignado para pbHash.

[in] dwFlags

Este parámetro está reservado para uso futuro y debe establecerse en cero.

[in] phPrevCatInfo

Puntero al identificador del contexto de catálogo anterior o NULL. Para obtener el primer catálogo que contiene el hash o para iniciar una enumeración de todos los catálogos, pase NULL para este parámetro. Para continuar con la enumeración, pase el valor devuelto de la llamada anterior hasta que no se encuentren más catálogos.

Valor devuelto

El valor devuelto es un identificador para el contexto del catálogo o NULL si no hay más catálogos que enumerar.

Nota: El tipo HCATINFO es simplemente una definición de tipo para HANDLE, lo que facilita el uso accidental de HCATINFO en el contexto incorrecto. En concreto, esto NO es lo mismo que un IDENTIFICADOR devuelto desde CryptCATOpen, aunque el compilador no le impedirá usar HCATINFO en ninguna función que espera un identificador de catálogo. Para adquirir un identificador de catálogo de esta función, primero llame a CryptCATCatalogInfoFromContext para obtener el nombre de archivo del catálogo y, a continuación, llame a CryptCATOpen con ese nombre de archivo.

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.

Nota: La función devuelve un valor de tipo HCATINFO, pero se trata simplemente de una definición de tipo para HANDLE. Por este motivo, es fácil usar accidentalmente HCATINFO al llamar a una función que espera un tipo diferente de HANDLE. En concreto, esto no es lo mismo que un IDENTIFICADOR devuelto desde CryptCATOpen, aunque el compilador no le impedirá usar HCATINFO en ninguna función que espera un identificador de catálogo.

Para adquirir un identificador de catálogo de esta función, primero llame a CryptCATCatalogInfoFromContext para obtener el nombre de archivo del catálogo y, a continuación, llame a CryptCATOpen con ese nombre de archivo para abrir el catálogo.

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