Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
PFNCMFILTERPROC
Collapse the table of content
Expand the table of content

PFNCMFILTERPROC callback function

The PFNCMFILTERPROC function is a filter procedure that filters each certificate to determine whether it will appear in the certificate selection dialog box that is displayed by the CertSelectCertificate function. PFNCMFILTERPROC is an application-defined callback function that is specified in the CERT_SELECT_STRUCT structure. The CERT_SELECT_STRUCT structure is a parameter in the CertSelectCertificate function. The PFNCMFILTERPROC function must be implemented by the developer to suit each application.

Syntax


BOOL WINAPI PFNCMFILTERPROC(
  _In_ PCCERT_CONTEXT pCertContext,
  _In_ DWORD          lCustData,
  _In_ DWORD          dwFlags,
  _In_ DWORD          dwDisplayWell
);

Parameters

pCertContext [in]

A pointer to a CERT_CONTEXT structure that contains a certificate to make a filtering determination on.

lCustData [in]

The address of an array of byte values that holds custom data. lCustData is passed to the PFNCMFILTERPROC function by the CertSelectCertificate function.

dwFlags [in]

Reserved for future use.

dwDisplayWell [in]

Reserved for future use.

Return value

Return a nonzero value (TRUE) to display the certificate. Return zero (FALSE) to not display the certificate.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

CryptDlg.h

See also

CertSelectCertificate
CERT_SELECT_STRUCT

 

 

Community Additions

ADD
Show:
© 2015 Microsoft