Expand Minimize

CERT_CREATE_CONTEXT_PARA structure

The CERT_CREATE_CONTEXT_PARA structure defines additional values that can be used when calling the CertCreateContext function.

Syntax


typedef struct {
  DWORD                             cbSize;
  PFN_CRYPT_FREE                    pfnFree;
  void                              *pvFree;
  PFN_CERT_CREATE_CONTEXT_SORT_FUNC pfnSort;
  void                              *pvSort;
} CERT_CREATE_CONTEXT_PARA;

Members

cbSize

The size, in bytes, of this structure.

pfnFree

A pointer to the function that frees the pbEncoded parameter of the CertCreateContext function. The pfnFree function is called when the context created by CertCreateContext is freed. This value can be NULL, in which case the pbEncoded parameter of the CertCreateContext function is not freed.

pvFree

The address of the memory that gets freed by the pfnFree function. If pvFree is NULL, then the pbEncoded parameter of the CertCreateContext function is freed.

pfnSort

A PFN_CERT_CREATE_CONTEXT_SORT_FUNC function pointer that will be called for each sorted context entry.

This member is only present for a CERT_STORE_CTL_CONTEXT when the CERT_CREATE_CONTEXT_SORTED_FLAG flag is set in the dwFlags parameter of the CertCreateContext function. You must verify that this member is present before trying to access it by examining the cbSize member of this structure.

pvSort

An application-defined value that will be passed in the pvSort parameter of the PFN_CERT_CREATE_CONTEXT_SORT_FUNC callback function.

This member is only present for a CERT_STORE_CTL_CONTEXT when the CERT_CREATE_CONTEXT_SORTED_FLAG flag is set in the dwFlags parameter of the CertCreateContext function. You must verify that this member is present before trying to access it by examining the cbSize member of this structure.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wincrypt.h

See also

CertCreateContext
PFN_CERT_CREATE_CONTEXT_SORT_FUNC

 

 

Community Additions

ADD
Show:
© 2015 Microsoft