ec_message_blobject_get

ec_message_blobject_get — Retrieve a blobject tag

#include "ec_message.h"

| ec_blobject * **ec_message_blobject_get** ( | msg, |   | |   | key); |   |

ec_message * <var class="pdparam">msg</var>; const char * <var class="pdparam">key</var>;

Retrieve a blobject tag using the key. If the object is found, it adds a reference to it and returns the ec_blobject address to the caller. The caller is responsible for delrefing it when done.

Parameters

Return Values

A pointer to an ec_blobject struct. For documentation of this data structure see “ec_blobject” Returns the address of the blobject if found, or NULL otherwise. If an object is returned, you own a reference to it and must delete the reference when you are finished using it.

Threading

It is legal to call this function in any thread.

ec_message_blobject_store and ec_message_blobject_remove.