asyncmsg_connect_attr()

Examine or change connection attributes for asynchronous messaging

---

Asynchronous messaging is an experimental feature; for information about the use of experimental software, see the Commercial Software License Agreement (CSLA) or Partner Software License Agreement (PSLA) in the Licensing area of our website, http://www.qnx.com/legal/licensing/.

---

Synopsis:

#include <sys/asyncmsg.h> 

int asyncmsg_connect_attr (
      int coid,
      struct _asyncmsg_connection_attr *old_attr, 
      const struct _asyncmsg_connection_attr *new_attr);

Arguments:

coid

The connection ID.

old_attr

NULL, or a pointer to a _asyncmsg_connection_attr structure where the function can store the current attributes for the connection.

new_attr

NULL, or a pointer to a _asyncmsg_connection_attr structure that specifies the attributes to set for the connection.

Library:

libasyncmsg

Use the -l asyncmsg option to qcc to link against this library.

Description:

You can use asyncmsg_connect_attr() to get or set the attributes to the connection used for asynchronous messaging:

• If old_attr isn't NULL, the function stores the current connection attributes in the structure that it points to.
• If new_attr isn't NULL, the function sets the connection attributes to the contents of the buffer it points to.

Returns:

EOK, or -1 if an error occurred (errno is set).

Errors:

EINVAL

The connection specified by coid doesn't exist.

Classification:

QNX Neutrino

See also:

asyncmsg_channel_create(), asyncmsg_channel_destroy(), asyncmsg_connect_attach(), asyncmsg_connect_detach(), _asyncmsg_connection_attr, asyncmsg_flush(), asyncmsg_free(), asyncmsg_get(), asyncmsg_malloc(), asyncmsg_put(), asyncmsg_putv()

Asynchronous Messaging Technote