cwbDQ_GetAuthority

Purpose

Get the attribute for the authority that other users will have to the data queue.

Syntax

 
unsigned int CWB_ENTRY cwbDQ_GetAuthority(
                             cwbDQ_Attr          queueAttributes,
                             unsigned short     *authority);

Parameters

cwbDQ_Attr queueAttributes - input
Handle of the data queue attributes returned by a previous call to cwbDQ_CreateAttr.
unsigned short * authority - output
Pointer to an unsigned short to where the authority will be written. This value will be one of the following defined types:
  • CWBDQ_ALL
  • CWBDQ_EXCLUDE
  • CWBDQ_CHANGE
  • CWBDQ_USE
  • CWBDQ_LIBCRTAUT

Return Codes

The following list shows common return values.

CWB_OK
Successful completion.
CWB_INVALID_POINTER
Bad or null pointer.
CWBDQ_INVALID_ATTRIBUTE_HANDLE
Invalid attributes handle.

Usage

None