Digital

NAME

XieQueryTmp − This routine obtains information about a TMP from the server. 

C Format

data_list = XieQueryTmp(tmp_id, x_ret, y_ret, count_ret)

C Argument Information

XieTemplate   data_list;
XieTmp      tmp_id;
long      ∗x_ret;
long      ∗y_ret;
unsigned long  ∗count_ret;

RETURN VALUES

The routine returns the address of an array of template records of type XieTemplateRec in the data_list argument. You can free the array using the XieFree routine. 

PARAMETERS

tmp_idThe tmp_id argument specifies the identifier of the TMP you want to query. 

x_retThe x_ret argument specifies the pointer to the location to which the routine returns the x-coordinate of the template center. 

y_retThe y_ret argument specifies the pointer to the location to which the routine returns the y-coordinate of the template center. 

count_retThe count_ret argument specifies the pointer to the location to which the routine returns the count of the number of entries in data_list. 

DESCRIPTION

This routine obtains information about a TMP from the server.  If you do not want to retrieve information about a particular argument, set the associated pointer to null. 

XIE Events and Error Messages

Protocol Messages: X_ieQueryResource

XIE event returned: None

XieLib errors: Reply error, BadLength

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources