虚函数

GioTlsDatabaselookup_certificate_for_handle

自：2.30

声明 [源]

GTlsCertificate*
lookup_certificate_for_handle (
  GTlsDatabase* self,
  const gchar* handle,
  GTlsInteraction* interaction,
  GTlsDatabaseLookupFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

通过处理器查找证书。

处理器应该是通过在相同TLS后端的对象上调用g_tls_database_create_certificate_handle()创建的。处理器旨在在数据库实例之间保持有效。

如果处理器不再有效，或未指向此数据库中的证书，则返回NULL。

此函数可能阻塞，可以使用g_tls_database_lookup_certificate_for_handle_async()以异步方式执行查找操作。

自：2.30

参数

处理器

类型： const gchar*

证书处理器。

数据由方法的调用者拥有。
值是UTF-8字符串，以NUL结尾。
交互

类型： GTlsInteraction

用必要的话与用户交互。

参数可以是NULL。
数据由方法的调用者拥有。
标志

类型： GTlsDatabaseLookupFlags

影响查找的标志。

可撤销的

类型： GCancellable

一个GCancellable，或NULL。

参数可以是NULL。
数据由方法的调用者拥有。
错误

类型： GError **

恢复错误的返回位置。

参数可以是NULL。
如果返回位置不是NULL，则必须将其初始化为NULL GError*。
如果没有错误，则虚拟函数将参数初始化为NULL。
如果发生错误，则参数将被设置为一个新的GError；调用者将拥有数据，并负责释放它。

返回值

类型： GTlsCertificate

新分配的GTlsCertificate，或NULL。使用g_object_unref()来释放证书。

方法的调用者拥有返回的数据，并负责释放它。
返回值可以是NULL。