Compartilhar via


Função de retorno de chamada PFNCMFILTERPROC (cryptdlg.h)

A função PFNCMFILTERPROC é um procedimento de filtro que filtra cada certificado para determinar se ele aparecerá na caixa de diálogo de seleção de certificado exibida pela função CertSelectCertificate . PFNCMFILTERPROC é uma função de retorno de chamada definida pelo aplicativo especificada na estrutura CERT_SELECT_STRUCT . A estrutura CERT_SELECT_STRUCT é um parâmetro na função CertSelectCertificate . A função PFNCMFILTERPROC deve ser implementada pelo desenvolvedor para atender a cada aplicativo.

Sintaxe

PFNCMFILTERPROC Pfncmfilterproc;

BOOL Pfncmfilterproc(
  PCCERT_CONTEXT pCertContext,
  LPARAM unnamedParam2,
  DWORD unnamedParam3,
  DWORD unnamedParam4
)
{...}

Parâmetros

pCertContext

Um ponteiro para uma estrutura CERT_CONTEXT que contém um certificado no qual fazer uma determinação de filtragem.

unnamedParam2

dwDisplayWell. Reservado para uso futuro.

unnamedParam3

Esse DWORD parâmetro é dwFlags.

unnamedParam4

Esse DWORD parâmetro é lCustData. É o endereço de uma matriz de valores de bytes que contém dados personalizados. lCustData é passado para a função PFNCMFILTERPROC pela função CertSelectCertificate .

Retornar valor

Retornar um valor diferente de zero (TRUE) para exibir o certificado. Retornar zero (FALSE) para não exibir o certificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cryptdlg.h

Confira também

CERT_SELECT_STRUCT

CertSelectCertificate