Compartilhar via


Função CryptCATAdminRemoveCatalog (mscat.h)

[A função CryptCATAdminRemoveCatalog 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 CryptCATAdminRemoveCatalog exclui um arquivo de catálogo e remove a entrada desse catálogo do banco de dados do catálogo do Windows. Essa função é a única maneira com suporte para remover catálogos do banco de dados, garantindo a integridade do banco de dados. A função não tem nenhuma biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Wintrust.dll.

Sintaxe

BOOL CryptCATAdminRemoveCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] LPCWSTR   pwszCatalogFile,
  [in] DWORD     dwFlags
);

Parâmetros

[in] hCatAdmin

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

[in] pwszCatalogFile

Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do catálogo a ser removido. Essa cadeia de caracteres deve conter apenas o nome, sem nenhuma informação de caminho.

[in] dwFlags

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

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida; FALSE se a função falhar.

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.

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

CryptCATAdminAddCatalog