# Message Engine
[Message Engine]

## Virtual Functions

A message engine contains some pointers to functions which allow extending the functionality of a message engine (like virtual functions in C++)
typedef int(* | GWEN_MSGENGINE_BINTYPEREAD_PTR )(GWEN_MSGENGINE *e, GWEN_XMLNODE *node, GWEN_DB_NODE *gr, GWEN_BUFFER *vbuf)
typedef int(* | GWEN_MSGENGINE_BINTYPEWRITE_PTR )(GWEN_MSGENGINE *e, GWEN_XMLNODE *node, GWEN_DB_NODE *gr, GWEN_BUFFER *dbuf)
typedef void(* | GWEN_MSGENGINE_FREEDATA_PTR )(GWEN_MSGENGINE *e)
typedef const char *(* | GWEN_MSGENGINE_GETCHARVALUE_PTR )(GWEN_MSGENGINE *e, const char *name, const char *defValue)
typedef GWEN_DB_NODE *(* | GWEN_MSGENGINE_GETGLOBALVALUES_PTR )(GWEN_MSGENGINE *e)
typedef int(* | GWEN_MSGENGINE_GETINTVALUE_PTR )(GWEN_MSGENGINE *e, const char *name, int defValue)
typedef GWEN_DB_VALUETYPE(* | GWEN_MSGENGINE_TYPECHECK_PTR )(GWEN_MSGENGINE *e, const char *tname)
typedef int(* | GWEN_MSGENGINE_TYPEREAD_PTR )(GWEN_MSGENGINE *e, GWEN_BUFFER *msgbuf, GWEN_XMLNODE *node, GWEN_BUFFER *vbuf, char escapeChar, const char *delimiters)
typedef int(* | GWEN_MSGENGINE_TYPEWRITE_PTR )(GWEN_MSGENGINE *e, GWEN_BUFFER *gbuf, GWEN_BUFFER *data, GWEN_XMLNODE *node)

## Setters And Getters

GWENHYWFAR_API int | GWEN_MsgEngine_AddDefinitions (GWEN_MSGENGINE *e, GWEN_XMLNODE *node)
GWENHYWFAR_API const char * | GWEN_MsgEngine_GetCharsToEscape (GWEN_MSGENGINE *e)
GWENHYWFAR_API GWEN_XMLNODE * | GWEN_MsgEngine_GetDefinitions (GWEN_MSGENGINE *e)
GWENHYWFAR_API const char * | GWEN_MsgEngine_GetDelimiters (GWEN_MSGENGINE *e)
GWENHYWFAR_API char | GWEN_MsgEngine_GetEscapeChar (GWEN_MSGENGINE *e)
GWENHYWFAR_API const char * | GWEN_MsgEngine_GetMode (GWEN_MSGENGINE *e)
GWENHYWFAR_API unsigned int | GWEN_MsgEngine_GetProtocolVersion (GWEN_MSGENGINE *e)
GWENHYWFAR_API void | GWEN_MsgEngine_SetCharsToEscape (GWEN_MSGENGINE *e, const char *c)
GWENHYWFAR_API void | GWEN_MsgEngine_SetDefinitions (GWEN_MSGENGINE *e, GWEN_XMLNODE *n, int take)
GWENHYWFAR_API void | GWEN_MsgEngine_SetDelimiters (GWEN_MSGENGINE *e, const char *s)
GWENHYWFAR_API void | GWEN_MsgEngine_SetEscapeChar (GWEN_MSGENGINE *e, char c)
GWENHYWFAR_API void | GWEN_MsgEngine_SetMode (GWEN_MSGENGINE *e, const char *mode)
GWENHYWFAR_API void | GWEN_MsgEngine_SetProtocolVersion (GWEN_MSGENGINE *e, unsigned int p)

## Handling Trust Information

GWENHYWFAR_API int | GWEN_MsgEngine_AddTrustInfo (GWEN_MSGENGINE *e, const char *data, unsigned int size, const char *description, GWEN_MSGENGINE_TRUSTLEVEL trustLevel, unsigned int pos)
GWENHYWFAR_API GWEN_MSGENGINE_TRUSTEDDATA * | GWEN_MsgEngine_TakeTrustInfo (GWEN_MSGENGINE *e)

## Constructor And Destructor

GWENHYWFAR_API void | GWEN_MsgEngine_Attach (GWEN_MSGENGINE *e)
GWENHYWFAR_API void | GWEN_MsgEngine_free (GWEN_MSGENGINE *e)
GWENHYWFAR_API GWEN_MSGENGINE * | GWEN_MsgEngine_new ()

## Parsing, Listing And Creating Messages

GWENHYWFAR_API int | GWEN_MsgEngine_CreateMessage (GWEN_MSGENGINE *e, const char *msgName, int msgVersion, GWEN_BUFFER *gbuf, GWEN_DB_NODE *msgData)
GWENHYWFAR_API int | GWEN_MsgEngine_CreateMessageFromNode (GWEN_MSGENGINE *e, GWEN_XMLNODE *node, GWEN_BUFFER *gbuf, GWEN_DB_NODE *msgData)
GWENHYWFAR_API GWEN_XMLNODE * | GWEN_MsgEngine_ListMessage (GWEN_MSGENGINE *e, const char *typ, const char *msgName, int msgVersion, GWEN_TYPE_UINT32 flags)
GWENHYWFAR_API int | GWEN_MsgEngine_ParseMessage (GWEN_MSGENGINE *e, GWEN_XMLNODE *group, GWEN_BUFFER *msgbuf, GWEN_DB_NODE *gr, GWEN_TYPE_UINT32 flags)
GWENHYWFAR_API int | GWEN_MsgEngine_ReadMessage (GWEN_MSGENGINE *e, const char *gtype, GWEN_BUFFER *mbuf, GWEN_DB_NODE *gr, GWEN_TYPE_UINT32 flags)
GWENHYWFAR_API int | GWEN_MsgEngine_ShowMessage (GWEN_MSGENGINE *e, const char *typ, const char *msgName, int msgVersion, GWEN_TYPE_UINT32 flags)
GWENHYWFAR_API int | GWEN_MsgEngine_SkipSegment (GWEN_MSGENGINE *e, GWEN_BUFFER *msgbuf, unsigned char escapeChar, unsigned char delimiter)

## Locating XML Nodes And Properties

GWENHYWFAR_API GWEN_XMLNODE * | GWEN_MsgEngine_FindGroupByProperty (GWEN_MSGENGINE *e, const char *pname, int version, const char *pvalue)
GWENHYWFAR_API GWEN_XMLNODE * | GWEN_MsgEngine_FindNodeByProperty (GWEN_MSGENGINE *e, const char *t, const char *pname, int version, const char *pvalue)
GWENHYWFAR_API const char * | GWEN_MsgEngine_SearchForProperty (GWEN_XMLNODE *node, GWEN_XMLNODE *refnode, const char *name, int topDown)

## Setters For Virtual Functions: Extending Binary Data Handling

GWENHYWFAR_API GWEN_MSGENGINE_BINTYPEREAD_PTR | GWEN_MsgEngine_GetBinTypeReadFunction (GWEN_MSGENGINE *e)
GWENHYWFAR_API GWEN_MSGENGINE_BINTYPEWRITE_PTR | GWEN_MsgEngine_GetBinTypeWriteFunction (GWEN_MSGENGINE *e)
GWENHYWFAR_API void | GWEN_MsgEngine_SetBinTypeReadFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_BINTYPEREAD_PTR p)
GWENHYWFAR_API void | GWEN_MsgEngine_SetBinTypeWriteFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_BINTYPEWRITE_PTR p)

## Setters For Virtual Functions: Extending Data Type Handling

GWENHYWFAR_API GWEN_MSGENGINE_GETGLOBALVALUES_PTR | GWEN_MsgEngine_GetGetGlobalValuesFunction (GWEN_MSGENGINE *e)
GWENHYWFAR_API GWEN_MSGENGINE_TYPECHECK_PTR | GWEN_MsgEngine_GetTypeCheckFunction (GWEN_MSGENGINE *e)
GWENHYWFAR_API GWEN_MSGENGINE_TYPEREAD_PTR | GWEN_MsgEngine_GetTypeReadFunction (GWEN_MSGENGINE *e)
GWENHYWFAR_API GWEN_MSGENGINE_TYPEWRITE_PTR | GWEN_MsgEngine_GetTypeWriteFunction (GWEN_MSGENGINE *e)
GWENHYWFAR_API void | GWEN_MsgEngine_SetGetGlobalValuesFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_GETGLOBALVALUES_PTR p)
GWENHYWFAR_API void | GWEN_MsgEngine_SetTypeCheckFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_TYPECHECK_PTR p)
GWENHYWFAR_API void | GWEN_MsgEngine_SetTypeReadFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_TYPEREAD_PTR p)
GWENHYWFAR_API void | GWEN_MsgEngine_SetTypeWriteFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_TYPEWRITE_PTR p)

## Extending GWEN_MSGENGINE

The functions in this group are strongly deprecated.
GWENHYWFAR_API void * | GWEN_MsgEngine_GetInheritorData (const GWEN_MSGENGINE *e)
GWENHYWFAR_API void | GWEN_MsgEngine_SetFreeDataFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_FREEDATA_PTR p)
GWENHYWFAR_API void | GWEN_MsgEngine_SetInheritorData (GWEN_MSGENGINE *e, void *d)

## Getters And Setters for Global Variables

GWENHYWFAR_API int | GWEN_MsgEngine_GetIntValue (GWEN_MSGENGINE *e, const char *path, int defValue)
GWENHYWFAR_API const char * | GWEN_MsgEngine_GetValue (GWEN_MSGENGINE *e, const char *path, const char *defValue)
GWENHYWFAR_API int | GWEN_MsgEngine_SetIntValue (GWEN_MSGENGINE *e, const char *path, int value)
GWENHYWFAR_API int | GWEN_MsgEngine_SetValue (GWEN_MSGENGINE *e, const char *path, const char *value)

## Setters For Virtual Functions: Getting Variables

GWENHYWFAR_API void | GWEN_MsgEngine_SetGetCharValueFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_GETCHARVALUE_PTR p)
GWENHYWFAR_API void | GWEN_MsgEngine_SetGetIntValueFunction (GWEN_MSGENGINE *e, GWEN_MSGENGINE_GETINTVALUE_PTR p)

## Typedefs

typedef GWEN__MSGENGINE | GWEN_MSGENGINE

## Typedef Documentation

typedef struct GWEN__MSGENGINE GWEN_MSGENGINE

typedef int(* GWEN_MSGENGINE_BINTYPEREAD_PTR)(GWEN_MSGENGINE *e, GWEN_XMLNODE *node, GWEN_DB_NODE *gr, GWEN_BUFFER *vbuf)

typedef int(* GWEN_MSGENGINE_BINTYPEWRITE_PTR)(GWEN_MSGENGINE *e, GWEN_XMLNODE *node, GWEN_DB_NODE *gr, GWEN_BUFFER *dbuf)

typedef void(* GWEN_MSGENGINE_FREEDATA_PTR)(GWEN_MSGENGINE *e)

typedef const char*(* GWEN_MSGENGINE_GETCHARVALUE_PTR)(GWEN_MSGENGINE *e, const char *name, const char *defValue)

| Get the value of the given name (or default value if none set)

typedef GWEN_DB_NODE*(* GWEN_MSGENGINE_GETGLOBALVALUES_PTR)(GWEN_MSGENGINE *e)

typedef int(* GWEN_MSGENGINE_GETINTVALUE_PTR)(GWEN_MSGENGINE *e, const char *name, int defValue)

typedef GWEN_DB_VALUETYPE(* GWEN_MSGENGINE_TYPECHECK_PTR)(GWEN_MSGENGINE *e, const char *tname)

| Checks of what base-type the given type is.

typedef int(* GWEN_MSGENGINE_TYPEREAD_PTR)(GWEN_MSGENGINE *e, GWEN_BUFFER *msgbuf, GWEN_XMLNODE *node, GWEN_BUFFER *vbuf, char escapeChar, const char *delimiters)

typedef int(* GWEN_MSGENGINE_TYPEWRITE_PTR)(GWEN_MSGENGINE *e, GWEN_BUFFER *gbuf, GWEN_BUFFER *data, GWEN_XMLNODE *node)

Returns:
  0 on success, -1 on error, 1 if unknown type

## Function Documentation

GWENHYWFAR_API int GWEN_MsgEngine_AddDefinitions | ( | GWEN_MSGENGINE * | e,
|  | GWEN_XMLNODE * | node
| ) |

GWENHYWFAR_API int GWEN_MsgEngine_AddTrustInfo | ( | GWEN_MSGENGINE * | e,
|  | const char * | data,
|  | unsigned int | size,
|  | const char * | description,
|  | GWEN_MSGENGINE_TRUSTLEVEL | trustLevel,
|  | unsigned int | pos
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_Attach | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API int GWEN_MsgEngine_CreateMessage | ( | GWEN_MSGENGINE * | e,
|  | const char * | msgName,
|  | int | msgVersion,
|  | GWEN_BUFFER * | gbuf,
|  | GWEN_DB_NODE * | msgData
| ) |

GWENHYWFAR_API int GWEN_MsgEngine_CreateMessageFromNode | ( | GWEN_MSGENGINE * | e,
|  | GWEN_XMLNODE * | node,
|  | GWEN_BUFFER * | gbuf,
|  | GWEN_DB_NODE * | msgData
| ) |

GWENHYWFAR_API GWEN_XMLNODE* GWEN_MsgEngine_FindGroupByProperty | ( | GWEN_MSGENGINE * | e,
|  | const char * | pname,
|  | int | version,
|  | const char * | pvalue
| ) |

GWENHYWFAR_API GWEN_XMLNODE* GWEN_MsgEngine_FindNodeByProperty | ( | GWEN_MSGENGINE * | e,
|  | const char * | t,
|  | const char * | pname,
|  | int | version,
|  | const char * | pvalue
| ) |

| Looks for a node of the given type. Example: If type is "GROUP" then the node will be searched in "<GROUPS>", and the tag name will be "<GROUPdef>".

GWENHYWFAR_API void GWEN_MsgEngine_free | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_MSGENGINE_BINTYPEREAD_PTR GWEN_MsgEngine_GetBinTypeReadFunction | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_MSGENGINE_BINTYPEWRITE_PTR GWEN_MsgEngine_GetBinTypeWriteFunction | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API const char* GWEN_MsgEngine_GetCharsToEscape | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_XMLNODE* GWEN_MsgEngine_GetDefinitions | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API const char* GWEN_MsgEngine_GetDelimiters | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API char GWEN_MsgEngine_GetEscapeChar | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_MSGENGINE_GETGLOBALVALUES_PTR GWEN_MsgEngine_GetGetGlobalValuesFunction | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API void* GWEN_MsgEngine_GetInheritorData | ( | const GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API int GWEN_MsgEngine_GetIntValue | ( | GWEN_MSGENGINE * | e,
|  | const char * | path,
|  | int | defValue
| ) |

GWENHYWFAR_API const char* GWEN_MsgEngine_GetMode | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API unsigned int GWEN_MsgEngine_GetProtocolVersion | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_MSGENGINE_TYPECHECK_PTR GWEN_MsgEngine_GetTypeCheckFunction | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_MSGENGINE_TYPEREAD_PTR GWEN_MsgEngine_GetTypeReadFunction | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API GWEN_MSGENGINE_TYPEWRITE_PTR GWEN_MsgEngine_GetTypeWriteFunction | ( | GWEN_MSGENGINE * | e | ) |

GWENHYWFAR_API const char* GWEN_MsgEngine_GetValue | ( | GWEN_MSGENGINE * | e,
|  | const char * | path,
|  | const char * | defValue
| ) |

GWENHYWFAR_API GWEN_XMLNODE* GWEN_MsgEngine_ListMessage | ( | GWEN_MSGENGINE * | e,
|  | const char * | typ,
|  | const char * | msgName,
|  | int | msgVersion,
|  | GWEN_TYPE_UINT32 | flags
| ) |

| This function creates a full tree of all groups and elements used by the given message. The caller is responsible for freeing the data returned.

GWENHYWFAR_API GWEN_MSGENGINE* GWEN_MsgEngine_new | ( |  | ) |

GWENHYWFAR_API int GWEN_MsgEngine_ParseMessage | ( | GWEN_MSGENGINE * | e,
|  | GWEN_XMLNODE * | group,
|  | GWEN_BUFFER * | msgbuf,
|  | GWEN_DB_NODE * | gr,
|  | GWEN_TYPE_UINT32 | flags
| ) |

| This function parses a single entity specified by a single XML node (which may of course consist of multiple XML nodes). This function makes no assumptions about the format of used variables whatsoever. All data parsed from the given message is stored within the given database.

GWENHYWFAR_API int GWEN_MsgEngine_ReadMessage | ( | GWEN_MSGENGINE * | e,
|  | const char * | gtype,
|  | GWEN_BUFFER * | mbuf,
|  | GWEN_DB_NODE * | gr,
|  | GWEN_TYPE_UINT32 | flags
| ) |

This function reads all segments found within the given buffer. This is used to read a full message containing multiple segments. It assumes that each segment starts with a group with the id of "SegHead" which defines the variable "code" to determine each segment type. Please note that this function makes no further assumptions about the format of a segment, group or element of a message. This is totally based on the settings specified in the XML file. Unknown segments are simply skipped. For each segment found inside the message a group is created within the given database. The name of that group is derived from the property "id" within the XML description of each segment (or "code" if "id" does not exist). One special group is created below every segment group: "segment". This group contains some variables:

- pos holding the start position of the segment inside the buffer
- length holding the length of the area occupied by the segment

The data of every segment is simply added to the database, so there may be multiple groups with the same name if a given segment type occurs more often than once.

Returns:
  0 if ok, -1 on error and 1 if no segment was available

Parameters:

  | e | message engine
  | gtype | typename for segments (most callers use "SEG")
  | mbuf | GWEN_BUFFER containing the message. Parsing is started at the current position within the buffer, so please make sure that this pos is set to the beginning of the message before calling this function.
  | gr | database to store information parsed from the given message
  | flags | see GWEN_MSGENGINE_READ_FLAGS_TRUSTINFO and GWEN_MSGENGINE_READ_FLAGS_DEFAULT

GWENHYWFAR_API const char* GWEN_MsgEngine_SearchForProperty | ( | GWEN_XMLNODE * | node,
|  | GWEN_XMLNODE * | refnode,
|  | const char * | name,
|  | int | topDown
| ) |

| Searches for a property in "node" and in "refnode" and all its parents. If topdown is 0 then the nearest value is used, otherwise the farest one is used.

GWENHYWFAR_API void GWEN_MsgEngine_SetBinTypeReadFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_BINTYPEREAD_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetBinTypeWriteFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_BINTYPEWRITE_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetCharsToEscape | ( | GWEN_MSGENGINE * | e,
|  | const char * | c
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetDefinitions | ( | GWEN_MSGENGINE * | e,
|  | GWEN_XMLNODE * | n,
|  | int | take
| ) |

Parameters:

  | e | message engine for which the definition is to be added
  | n | xml node to add
  | take | if !=0 then the message engine will take over ownership of the XML node.

GWENHYWFAR_API void GWEN_MsgEngine_SetDelimiters | ( | GWEN_MSGENGINE * | e,
|  | const char * | s
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetEscapeChar | ( | GWEN_MSGENGINE * | e,
|  | char | c
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetFreeDataFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_FREEDATA_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetGetCharValueFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_GETCHARVALUE_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetGetGlobalValuesFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_GETGLOBALVALUES_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetGetIntValueFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_GETINTVALUE_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetInheritorData | ( | GWEN_MSGENGINE * | e,
|  | void * | d
| ) |

GWENHYWFAR_API int GWEN_MsgEngine_SetIntValue | ( | GWEN_MSGENGINE * | e,
|  | const char * | path,
|  | int | value
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetMode | ( | GWEN_MSGENGINE * | e,
|  | const char * | mode
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetProtocolVersion | ( | GWEN_MSGENGINE * | e,
|  | unsigned int | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetTypeCheckFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_TYPECHECK_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetTypeReadFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_TYPEREAD_PTR | p
| ) |

GWENHYWFAR_API void GWEN_MsgEngine_SetTypeWriteFunction | ( | GWEN_MSGENGINE * | e,
|  | GWEN_MSGENGINE_TYPEWRITE_PTR | p
| ) |

GWENHYWFAR_API int GWEN_MsgEngine_SetValue | ( | GWEN_MSGENGINE * | e,
|  | const char * | path,
|  | const char * | value
| ) |

| Set a global variable which will be used for "$"-Variables in description files.

GWENHYWFAR_API int GWEN_MsgEngine_ShowMessage | ( | GWEN_MSGENGINE * | e,
|  | const char * | typ,
|  | const char * | msgName,
|  | int | msgVersion,
|  | GWEN_TYPE_UINT32 | flags
| ) |

| Deprecated, use GWEN_MsgEngine_ListMessage instead.

GWENHYWFAR_API int GWEN_MsgEngine_SkipSegment | ( | GWEN_MSGENGINE * | e,
|  | GWEN_BUFFER * | msgbuf,
|  | unsigned char | escapeChar,
|  | unsigned char | delimiter
| ) |

This function skips all bytes from the given buffer until the given delimiter is found or the buffer ends. It also takes care of escape characters (to not accidentally take an escaped delimiter for a real one) and is able to identify and correctly skip binary data. For the latter to work it takes into account that binary data is preceeded by a "@123@" sequence, where "123" is the length of the binary data. This sequence has been taken from the HBCI specs (German homebanking protocol) and has proven to be very effective ;-)

GWENHYWFAR_API GWEN_MSGENGINE_TRUSTEDDATA* GWEN_MsgEngine_TakeTrustInfo | ( | GWEN_MSGENGINE * | e | ) |

This function returns trust info gathered while parsing a message. The caller of this function takes over ownership of this list of data, so it is his responsibility to free it.

Returns:
  list of trust data (0 if none)