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 |
|
See also