CertDeleteCTLFromStore function (wincrypt.h)

The CertDeleteCTLFromStore function deletes the specified certificate trust list (CTL) context from a certificate store.

Syntax

BOOL CertDeleteCTLFromStore(
  [in] PCCTL_CONTEXT pCtlContext
);

Parameters

[in] pCtlContext

A pointer to the CTL_CONTEXT structure to be deleted.

Return value

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. For extended error information, call GetLastError. One possible error code is the following.

Return code Description
E_ACCESSDENIED
The store was opened read-only, and a delete operation is not allowed.

Remarks

All subsequent get or find operations for the CTL in this store fail. However, memory allocated for the CTL is not freed until all duplicated contexts have also been freed.

The pCtlContext parameter is always freed by this function by using CertFreeCTLContext, even for an error.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

See also

CertFreeCTLContext

Certificate Trust List Functions