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