ec_message_rsrc_get
Name
ec_message_rsrc_get — This will return the I/O object associated with the resource name as well as the state
Synopsis
#include "ec_message.h"
| io_object * **ec_message_rsrc_get** (
| message, | |
| | name, | |
| | state)
; | |
ec_message * <var class="pdparam">message</var>
;
const char * <var class="pdparam">name</var>
;
int * <var class="pdparam">state</var>
;
Description
Note
This reference page was automatically generated from functions found in the header files in the development branch. The function described here may not exist in generally available versions of Momentum, and may change in behavior when it is generally available. Consult your vendor for definitive advice on the use of this function.
This will return the I/O object associated with the resource name as well as the state.
The function will return NULL only if it has set *state to EC_MESSAGE_RSRC_NONE or EC_MESSAGE_RSRC_DELETED. The value of *state may be different than the value returned by a preceding ec_message_rsrc_state (the latter only serving as a hint for I/O object access). If state is NULL then it is ignored.
- message
-
the message to associate the resource with
- name
-
the name of the resource
- state
-
the state of the resource, may be NULL
Returns NULL on error and sets errno to indicate the problem if *state is either EC_MESSAGE_RSRC_NONE or EC_MESSAGE_RSRC_DELETED.
**Configuration Change. ** This feature is available starting from Momentum 3.1.