Função CryptCATAdminEnumCatalogFromHash (mscat.h)

[A função CryptCATAdminEnumCatalogFromHash está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptCATAdminEnumCatalogFromHash enumera os catálogos que contêm um hash especificado. O hash normalmente é retornado da função CryptCATAdminCalcHashFromFileHandle . Após a chamada final para essa função, chame CryptCATAdminReleaseCatalogContext para liberar memória alocada.

Sintaxe

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

Parâmetros

[in] hCatAdmin

Um identificador para um contexto de administrador de catálogo atribuído anteriormente pela função CryptCATAdminAcquireContext .

[in] pbHash

Um ponteiro para o buffer que contém o hash recuperado chamando CryptCATAdminCalcHashFromFileHandle.

[in] cbHash

Número de bytes no buffer alocado para pbHash.

[in] dwFlags

Esse parâmetro é reservado para uso futuro e deve ser definido como zero.

[in] phPrevCatInfo

Um ponteiro para o identificador para o contexto de catálogo anterior ou NULL. Para obter o primeiro catálogo que contém o hash ou para iniciar uma enumeração de todos os catálogos, passe NULL para esse parâmetro. Para continuar a enumeração, passe o valor retornado da chamada anterior até que não sejam encontrados mais catálogos.

Retornar valor

O valor retornado será um identificador para o contexto do catálogo ou NULL se não houver mais catálogos para enumerar.

Nota: O tipo HCATINFO é simplesmente um typedef para HANDLE, o que facilita o uso acidental do HCATINFO no contexto errado. Em particular, isso NÃO é o mesmo que um HANDLE retornado de CryptCATOpen, embora o compilador não impeça que você use o HCATINFO em qualquer função que espere um identificador de catálogo. Para adquirir um identificador de catálogo dessa função, primeiro chame CryptCATCatalogInfoFromContext para obter o nome de arquivo do catálogo e, em seguida, chame CryptCATOpen com esse nome de arquivo.

Para obter informações de erro estendidas, chame a função GetLastError . Para obter uma lista completa dos códigos de erro fornecidos pelo sistema operacional, consulte Códigos de erro do sistema.

Nota: A função retorna um valor do tipo HCATINFO, mas este é simplesmente um typedef para HANDLE. Por isso, é fácil usar acidentalmente o HCATINFO ao chamar uma função que espera um tipo diferente de HANDLE. Em particular, isso não é o mesmo que um HANDLE retornado de CryptCATOpen, mesmo que o compilador não impeça que você use o HCATINFO em qualquer função que espere um identificador de catálogo.

Para adquirir um identificador de catálogo dessa função, primeiro chame CryptCATCatalogInfoFromContext para obter o nome de arquivo do catálogo e, em seguida, chame CryptCATOpen com esse nome de arquivo para abrir o catálogo.

Requisitos