This topic has not yet been rated - Rate this topic

CertFreeCertificateChain function

Applies to: desktop apps only

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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wincrypt.h

Library

Crypt32.lib

DLL

Crypt32.dll

See also

Certificate Chain Verification Functions
CertGetCertificateChain

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ