Deletes a query you added previously with rxAddQuery. You select the query to delete by passing in a query number. This number is given by rxAddQuery and the several search functions like rxFindQueryReference. The query number for a particular query is also returned as part of every document hit during routing.
In general you will delete queries based upon some criteria you stored in the query's title or reference. For instance you may have the title "Bob's basic title" for the user Bob.
Synopsis
void rxDeleteQuery( RouteX Router, ULongT QueryNum, StatusCodeT *Status )
Arguments
Router The RouteX object you are deleting QueryNum Returns the number of the query. Status A pointer to a value of type StatusCodeT. If an error occurs during the execution of the function a value representing the error will be stored in *Status. You should check *Status after every function call.
Returns
Nothing.
Related Functions
Example
rxQueryData aQuery; unsigned long querynum; // Set up the query I'm creating // We store the user name in the referenc and the // email address to forward the news to in the action. strcpy( aQuery.Title, "Forward news on Lextek"); strcpy( aQuery.Reference, "Someone"); strcpy( aQuery.Action, "someone@Lextek.com"); // we have to convert the query to hexadecimal form rxConvertQuery( aQuery.Query, "(lextek | onix | routex)" ); rxAddQuery( Router, &querynum, &aQuery, Status); if( *Status < 0 ) return;