PFNCMHOOKPROC callback function (cryptdlg.h)

The PFNCMHOOKPROC function is a hook procedure that is called before messages are processed by the certificate selection dialog box produced by the CertSelectCertificate function. The function allows the caller to customize the dialog box. PFNCMHOOKPROC is an application-defined callback function specified in the CERT_SELECT_STRUCT structure. The CERT_SELECT_STRUCT structure is a parameter in the CertSelectCertificate function. The PFNCMHOOKPROC function must be implemented by the developer to suit each application.

Syntax

PFNCMHOOKPROC Pfncmhookproc;

UINT Pfncmhookproc(
  [in] HWND hwndDialog,
  [in] UINT message,
  [in] WPARAM wParam,
  [in] LPARAM lParam
)
{...}

Parameters

[in] hwndDialog

A handle to a dialog box window.

[in] message

The message.

[in] wParam

Additional information about the message sent or posted.

[in] lParam

Additional information about the message sent or posted.

Return value

Return a nonzero value (TRUE) if this function processes the message. Return zero (FALSE) if this function does not process the message.

Remarks

For information about hooks, see Hooks.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header cryptdlg.h

See also

CERT_SELECT_STRUCT

CertSelectCertificate