CertFreeCertificateChain function

The CertFreeCertificateChain function frees a certificate chain by reducing its reference count. If the reference count becomes zero, memory allocated for the chain is released.

To free a context obtained by a get, duplicate, or create function, call the appropriate free function. To free a context obtained by a find or enumerate function, either pass it in as the previous context parameter to a subsequent invocation of the function, or call the appropriate free function. For more information, see the reference topic for the function that obtains the context.

Syntax

VOID WINAPI CertFreeCertificateChain(
  _In_ PCCERT_CHAIN_CONTEXT pChainContext
);

Parameters

pChainContext [in]

A pointer to a CERT_CHAIN_CONTEXT certificate chain context to be freed. If the reference count on the context reaches zero, the storage allocated for the context is freed.

Return value

This function does not return a value.

Examples

For an example that uses this function, see Example C Program: Creating a Certificate Chain.

Requirements

See also

Certificate Chain Verification Functions

CertGetCertificateChain