CertDeleteCTLFromStore function (wincrypt.h)

Article
02/22/2024

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