man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: July 2014
 
 

dat_cno_query(3DAT)

Name

dat_cno_query - provide the Consumer parameters of the CNO

Synopsis

cc [ flag… ] file–ldat [ library… ] 
#include <dat/udat.h>

DAT_RETURN
    dat_cno_query (
    IN    DAT_CNO_HANDLE          cno_handle,
    IN    DAT_CNO_PARAM_MASK      cno_param_mask,
    OUT   DAT_CNO_PARAM           *cno_param
    )

Parameters

cno_handle

Handle for the created instance of the Consumer Notification Object

cno_param_mask

Mask for CNO parameters

cno_param

Pointer to a Consumer-allocated structure that the Provider fills with CNO parameters

Description

The dat_cno_query() function provides the Consumer parameters of the CNO. The Consumer passes in a pointer to the Consumer-allocated structures for CNO parameters that the Provider fills.

The cno_param_mask parameter allows Consumers to specify which parameters to query. The Provider returns values for cno_param_mask requested parameters. The Provider can return values for any other parameters.

A value of DAT_OS_WAIT_PROXY_AGENT_NULL in cno_param indicates that there are no Proxy Agent associated with the CNO.

Return Values

DAT_SUCCESS

The operation was successful.

DAT_INVALID_PARAMETER

The cno_param_mask parameter is invalid.

DAT_INVALID_HANDLE

The cno_handle parameter is invalid.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Unsafe
Standard
uDAPL, 1.1, 1.2

See Also

libdat(3LIB), attributes(5)