Skip to main content

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

Was this page helpful?