ec_message_blobject_get

March 26, 2020 Contributors

Name

ec_message_blobject_get — Retrieve a blobject tag

Synopsis

#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>;

Description

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

msg

A pointer to an ec_message struct. For documentation of this data structure see “ec_message”.

key

Identifies the blobject to retrieve.

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.

See Also

ec_message_blobject_store and ec_message_blobject_remove.