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 |