GetFriendlyNameOfCertA 函数 (cryptdlg.h)

  • 项目

[ GetFriendlyNameOfCert 函数可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用带有 CERT_NAME_FRIENDLY_DISPLAY_TYPE 标志的 CertGetNameString 函数。]

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 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 cryptdlg.h
DLL CryptDlg.dll