GetFriendlyNameOfCertA 函式（cryptdlg.h）

[GetFriendlyNameOfCert 函式可用於需求區段中指定的操作系統。後續版本可能會變更或無法使用。請改用 CertGetNameString 函式搭配 CERT_NAME_FRIENDLY_DISPLAY_TYPE 旗標。]

GetFriendlyNameOfCert 函式會擷取憑證的顯示名稱。

注意此函式沒有相關聯的匯入連結庫。您必須使用 LoadLibrary 和 GetProcAddress 函式來動態連結至 CryptDlg.dll。

語法

CRYPTDLGAPI DWORD GetFriendlyNameOfCertA(
  [in]  PCCERT_CONTEXT pccert,
  [out] LPSTR          pch,
  [in]  DWORD          cch
);

[in] pccert

要擷取其顯示名稱之憑證內容的指標。

[out] pch

接收憑證顯示名稱之字元字串的指標。

[in] cch

配置給 pchBuffer的字元數，包括終止 NULL 字元。

傳回值是傳回顯示名稱中的字元數，包括終止 NULL 字元。

注意

cryptdlg.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetFriendlyNameOfCert 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。