Function
Valentcertificate_new_sync
unstable since: 1.0
Declaration [src]
GTlsCertificate*
valent_certificate_new_sync (
const char* path,
GError** error
)
Description [src]
Get a TLS certificate and private key pair.
This ensures a TLS certificate with the filename certificate.pem
and
private key with filename private.pem
exist in a directory at path
.
If either one doesn’t exist, a new certificate and private key pair will be
generated. The common name will be set to a string returned by
valent_device_generate_id()
.
If either generating or loading the certificate fails, NULL
will be returned
with error
set.
Available since: 1.0
Parameters
path
-
Type:
const char*
A directory path.
The data is owned by the caller of the function. The value is a platform-native string, using the preferred OS encoding on Unix and UTF-8 on Windows. error
-
Type:
GError **
The return location for a recoverable error.
The argument can be NULL
.If the return location is not NULL
, then you must initialize it to aNULL
GError*
.The argument will be left initialized to NULL
by the function if there are no errors.In case of error, the argument will be set to a newly allocated GError
; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: GTlsCertificate
A GTlsCertificate
.
The caller of the function takes ownership of the data, and is responsible for freeing it. |
The return value can be NULL . |