方法

GioTlsDatabaselookup_certificate_for_handle

自：2.30

声明 [源]

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

描述 [源]

通过句柄查找证书。

句柄应由在相同的TLS后端的 GTlsDatabase 对象上调用 g_tls_database_create_certificate_handle() 创建。句柄旨在在数据库的实例之间保持有效。

如果句柄已不再有效，或者不指向此数据库中的证书，则返回 NULL。

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

自：2.30

参数

句柄

类型: const gchar*

证书句柄。

数据由方法调用者拥有。

该值是 NUL 终止的 UTF-8 字符串。

交互

类型: GTlsInteraction

在需要时用于与用户交互。

该参数可以是 NULL。

数据由方法调用者拥有。

标志

类型: GTlsDatabaseLookupFlags

影响查找的标志。

cancellable

类型: GCancellable

一个 GCancellable，或 NULL。

该参数可以是 NULL。

数据由方法调用者拥有。

错误

类型: GError **

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

该参数可以是 NULL。

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

如果没有错误，方法将保留初始化的参数为 NULL。

发生错误时，参数将设置为一个新的 GError；调用者将获取数据的所有权，并负责释放它。

返回值

类型: GTlsCertificate

一个新的 GTlsCertificate，或 NULL。使用 g_object_unref() 释放证书。

方法的调用者将获取返回数据的所有权，并负责释放它。

返回值可以是 NULL。