Compartilhar via


Função CryptCATAdminAddCatalog (mscat.h)

[A função CryptCATAdminAddCatalog 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 CryptCATAdminAddCatalog adiciona um catálogo ao banco de dados de catálogo. O banco de dados do catálogo é um índice que associa hashes de arquivo aos catálogos que os contêm. Ele é usado para acelerar a identificação dos catálogos ao verificar a assinatura do arquivo. Essa função é a única maneira com suporte de adicionar catálogos programaticamente ao banco de dados do catálogo do Windows. A função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Wintrust.dll.

Sintaxe

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

Parâmetros

[in] hCatAdmin

Manipular atribuído anteriormente pela função CryptCATAdminAcquireContext .

[in] pwszCatalogFile

Um ponteiro para uma cadeia de caracteres terminada em nulo para o caminho totalmente qualificado do catálogo a ser adicionado.

[in] pwszSelectBaseName

Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do catálogo quando ele é armazenado. Se o parâmetro for NULL, um nome exclusivo será gerado para o catálogo.

[in] dwFlags

Se o sinalizador CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) for especificado, o catálogo especificado na chamada será vinculado a em vez de copiado. A vinculação rígida em vez de copiar um catálogo reduz a quantidade de espaço em disco exigida pelo Windows.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o contexto de informações do catálogo. Se a função falhar, o valor retornado será NULL. Depois de terminar de usar o identificador retornado, libere-o chamando a função CryptCATAdminReleaseCatalogContext .

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mscat.h
Biblioteca Wintrust.lib
DLL Wintrust.dll

Confira também

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext