pdcomm_opcua_license_status

Function

Copies the license status of this library as UTF-8 JSON.

int32_t pdcomm_opcua_license_status(uint8_t *output, size_t capacity, size_t *required)

Declared in: #include <pdcomm/opcua/pdcomm_opcua.h>

The object has schema_version 1 and reports build_date, host_id, program, the found sources, every license block in licenses with its verification (valid, malformed, unknown-key or invalid-signature), and modules, which maps each module id to its state (licensed, evaluation, missing, expired, not-yet-valid, updates-expired, program-mismatch or host-mismatch), granted and days_left. Pass a null output and zero capacity to query the size.

Parameters

Name	Description
output	Destination, or null when capacity is zero.
capacity	Size of output in bytes.
required	Receives the size of the JSON text.

Returns

#PDCOMM_OPCUA_OK, #PDCOMM_OPCUA_BUFFER_TOO_SMALL (the output is unchanged), #PDCOMM_OPCUA_INVALID_INPUT, or #PDCOMM_OPCUA_INTERNAL_ERROR.

Notes

• The text can change between a size query and the copy (time and license files); repeat the copy on #PDCOMM_OPCUA_BUFFER_TOO_SMALL. Added in ABI 0.2.