resmgr_ocb()

Retrieve an Open Control Block

Synopsis:

#include <sys/iofunc.h>
#include <sys/resmgr.h>

void * resmgr_ocb( resmgr_context_t * ctp);

Arguments:

ctp
A pointer to a resmgr_context_t structure that the resource-manager library uses to pass context information between functions.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The resmgr_ocb() function queries the internal resource manager database, which maps client connections to the server Open Control Block (OCB), to retrieve the OCB pointer that was previously bound using resmgr_open_bind().

Returns:

A pointer to the OCB for the matching binding, or NULL if the binding can't be found or an error occurred.

The OCB can be a structure that you define. By default, it's of type iofunc_ocb_t.

Errors:

ESRCH
The connection can't be located in the resource manager table.
ENOMEM
There isn't enough memory available for the operation.
EINVAL
Invalid arguments were used.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

See also:

iofunc_ocb_t, _msg_info, MsgInfo(), resmgr_iofuncs(), resmgr_open_bind(), resmgr_unbind()