CryptCATAdminRemoveCatalog function (mscat.h)
[The CryptCATAdminRemoveCatalog function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The CryptCATAdminRemoveCatalog function deletes a catalog file and removes that catalog's entry from the Windows catalog database. This function is the only supported way to remove catalogs from the database while ensuring the integrity of the database. The function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Wintrust.dll.
Syntax
BOOL CryptCATAdminRemoveCatalog(
[in] HCATADMIN hCatAdmin,
[in] LPCWSTR pwszCatalogFile,
[in] DWORD dwFlags
);
Parameters
[in] hCatAdmin
Handle previously assigned by the CryptCATAdminAcquireContext function.
[in] pwszCatalogFile
A pointer to a null-terminated string for the name of the catalog to remove. This string must contain only the name, without any path information.
[in] dwFlags
This parameter is reserved for future use and must be set to zero.
Return value
The return value is TRUE if the function succeeds; FALSE if the function fails.
For extended error information, call the GetLastError function. For a complete list of error codes provided by the operating system, see System Error Codes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | mscat.h |
| Library | Wintrust.lib |
| DLL | Wintrust.dll |