Gets information about a query.
struct resbuf*
ade_qlgetqryinfo(
ade_id qry_id,
char* info);
Returns the requested information or NULL.
| qry_id | Query ID. |
| info | Information type. See the Information Types table below. |
You must release the resbuf.
| name | Query name. |
| description | Query description. |
| category | Category name. |
| qtype | Query type: 1 = internal, 2 = external. |
| filename | For an externally saved query, full path name (string). |
A query gets a name and an ID when it is saved to a query category of the query library. A new query that you have not yet saved does not have a name or an ID.
The following sample obtains a query ID using ade_qlqrygetid(). Ade_qlgetqryinfo() is called with all required parameters and status information is displayed based on the resbuf returned by the function. The resbuf is then released as required.
char* pszQueryName = "LocAll";
ade_id queryId = ade_qlqrygetid(pszQueryName);
char* pszQueryInfo = "category";
struct resbuf* pQueryInfoRb = ade_qlgetqryinfo(
queryId,
pszQueryInfo);
if (NULL != pQueryInfoRb) {
acutPrintf(
"\nThe \"%s\" query is contained within the \"%s\" query category."
,pszQueryName, pQueryInfoRb->resval.rstring);
}
else {
acutPrintf(
"\nThe requested information could not be found.");
}
acutRelRb(pQueryInfoRb);