Add Opaque Byte Sequence

Convenience Method

Declaration

TibrvStatus addOpaque(
    const char*    fieldName,
    const void*    value,
    tibrv_u32      size
    tibrv_u16      fieldId=0);

Purpose

Add a field containing an opaque byte sequence.

Parameter

Description

fieldName

Create the new field with this name.

value

Add a new field that contains this opaque buffer.

The method copies the data into the new message field.

size

When adding an opaque buffer, the program supplies the size (in bytes) of the data in this parameter.

fieldId

Create the new field with this identifier. Zero is a special value that signifies no field identifier. All non-zero field identifiers must be unique within each message.

It is illegal to add a field that has both a NULL field name, and a non-zero field identifier.