PFNCMFILTERPROC 回呼函式 (cryptdlg.h)

  • 發行項

PFNCMFILTERPROC 函式是篩選程式，會篩選每個憑證，以判斷它是否會出現在 CertSelectCertificate 函式所顯示的憑證選取對話框中。 PFNCMFILTERPROC 是在 CERT_SELECT_STRUCT 結構中指定的應用程式定義回呼函式。 CERT_SELECT_STRUCT 結構是 CertSelectCertificate 函式中的參數。 PFNCMFILTERPROC 函式必須由開發人員實作，以符合每個應用程式。

語法

PFNCMFILTERPROC Pfncmfilterproc;

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

參數

pCertContext

CERT_CONTEXT 結構的指標，其中包含要進行篩選判斷的憑證。

unnamedParam2

dwDisplayWell。 保留供未來使用。

unnamedParam3

此參數 DWORD 為 dwFlags。

unnamedParam4

此參數 DWORD 為 lCustData。 它是保存自定義數據的位元組值數位位址。 lCustData 會由 CertSelectCertificate 函式傳遞至 PFNCMFILTERPROC 函式。

傳回值

傳回非零值 (TRUE) 以顯示憑證。 傳回零 (FALSE) 不顯示憑證。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 cryptdlg.h

另請參閱

CERT_SELECT_STRUCT

CertSelectCertificate