构造函数

GioTlsCertificatenew_from_files

自2.28起有效

声明 [源代码]

GTlsCertificate*
g_tls_certificate_new_from_files (
  const gchar* cert_file,
  const gchar* key_file,
  GError** error
)

描述 [源代码]

cert_filekey_file中PEM编码的数据创建一个新的GTlsCertificate。返回的证书将是cert_file中找到的第一个证书。从GLib 2.44起,如果cert_file包含多个证书,它将尝试加载一个证书链。所有证书将按找到的顺序验证(顶级证书应该是文件中的最后一个),如果验证成功,则相应地设置每个证书的GTlsCertificate:issuer属性。如果链中的任何证书无法验证,则仍将返回文件中的第一个证书。

如果任一文件无法读取或解析,该函数将返回NULL并将设置error。否则,它将像g_tls_certificate_new_from_pem()一样操作。

自2.28起有效

参数

cert_file

类型:const gchar*

包含要导入的一个或多个PEM编码证书的文件。

由函数的调用者拥有此数据。
该值是平台原生字符串,在Unix上使用首选操作系统编码,在Windows上使用UTF-8。
key_file

类型:const gchar*

包含要导入的PEM编码私钥的文件。

由函数的调用者拥有此数据。
该值是平台原生字符串,在Unix上使用首选操作系统编码,在Windows上使用UTF-8。
error

类型:GError **

一个可恢复错误的返回位置。

该参数可以是NULL
如果返回位置不为NULL,则必须将其初始化为空GError*
如果没有错误,构造函数将通过将参数初始化为NULL来保持参数初始化。
出错时,该参数将设置为新的GError;调用者将接管数据并负责释放它。

返回值

类型:GTlsCertificate

新的证书,或错误时为NULL

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