构造函数

GioTlsCertificatenew_from_pem

自 2.28 起可用

声明 [src]

GTlsCertificate*
g_tls_certificate_new_from_pem (
  const gchar* data,
  gssize length,
  GError** error
)

描述 [src]

从 data 中编码的 PEM 数据创建一个 GTlsCertificate。如果 data 包含证书和私钥，则返回的证书将包含私钥数据。（有关支持的格式信息，请参阅 GTlsCertificate:private-key-pem 属性。）

返回的证书将是 data 中发现的第一个证书。截至 GLib 2.44，如果 data 包含更多证书，它将尝试加载证书链。所有证书将以找到的顺序进行验证（顶级证书应该是文件中的最后一个），如果验证成功，则相应地设置每个证书的 GTlsCertificate:issuer 属性。如果链中的任何证书无法验证，文件中的第一个证书仍然将被返回。

自 2.28 起可用

参数

data

类型： const gchar*

PEM 编码的证书数据。

数据由函数的调用者拥有。

值是一个以 null 结尾的 UTF-8 字符串。

length

类型： gssize

data 的长度，或 -1 如果它以 null 结尾。

error

类型： GError **

可恢复错误的返回位置。

该参数可以是 NULL。

如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。

如果没有错误，构造函数将保留初始化到 NULL。

在出现错误的情况下，该参数将设置为一个新的分配的 GError；调用者将接管数据，并负责释放它。

返回值

类型： GTlsCertificate

新的证书，或 NULL 如果 data 无效。

函数的调用者将接管数据，并负责释放它。