Functions for managing SI queries. More...

#include "clDsmSystem.h"
#include "siQuery.h"
#include "linkList.h"
#include "cacheMgr.h"
#include "objectCarousel.h"
#include "sectionFilter.h"
#include "streamObject.h"
#include "loadMgr.h"

Functions
E_DscError	siQueryStart (P_DsmCoreInst idp, P_SIQueryRequest pQueryData, void *queryTarget, P_SIQueryResult pResult)
	Starts an SI Query. First tests if we have already made this query and the results are stored or still pending. Otherwise tries SI query callback. If results are not synchronously returned, stores state of query ready for when they are asynchronously returned (via clDsmProcessSiQueryEvent). NB. If start returns results SYNCHRONOUSLY then siQueryStop must not be called. More...

void	siQueryStop (P_DsmCoreInst idp, P_SiQuery pSiQueryRef)
	Stops the specified SI Query. Removes from any lists it is in and destroys associated memory object. NB. If siQueryStart returned results SYNCHRONOUSLY then this must not be called. More...

void	siQueryAbortPending (P_DsmCoreInst idp, P_SiQuery pSiQueryRef)
	Aborts the specified SI Query before completion. Stops/destroys duplicate queries. For original queries or duplicate queries that have expired parents (and no further duplicates) calls stop SI Query callback on relevant query. More...

E_DscError	siQueryProcessResult (P_DsmCoreInst idp, P_SiQuery pSiQueryRef, P_SIQueryResult pResult)
	Processes and stops the specified SI Query. More...

Detailed Description

Functions for managing SI queries.

Date: 07/05/2002

Author: N Kirkland

Function Documentation

void siQueryAbortPending	(	P_DsmCoreInst	idp,
		P_SiQuery	pSiQueryRef
	)

Aborts the specified SI Query before completion. Stops/destroys duplicate queries. For original queries or duplicate queries that have expired parents (and no further duplicates) calls stop SI Query callback on relevant query.

Parameters

idp	Pointer to instance data.
phPendingSiQueryRef	Pointer to handle of query to abort.

Returns

E_DscError siQueryProcessResult	(	P_DsmCoreInst	idp,
		P_SiQuery	pSiQueryRef,
		P_SIQueryResult	pResult
	)

Processes and stops the specified SI Query.

Parameters

idp	Pointer to instance data.
pSiQueryRef	Refererence for this query (value supplied at start time).
status	Status of query results.
pResult	Pointer to results of query (if successful).

Returns: CLDSM_OK (0) The process SI query event was executed with no problems. CLDSM_ERR_INVALID_SIQUERY_STATUS Supplied status value is invalid here. CLDSM_ERR_SYSTEM_ADD_SECTION_FILTER, Problem with add section filter callback.

E_DscError siQueryStart	(	P_DsmCoreInst	idp,
		P_SIQueryRequest	pQueryData,
		void *	queryTarget,
		P_SIQueryResult	pResult
	)

Starts an SI Query. First tests if we have already made this query and the results are stored or still pending. Otherwise tries SI query callback. If results are not synchronously returned, stores state of query ready for when they are asynchronously returned (via clDsmProcessSiQueryEvent). NB. If start returns results SYNCHRONOUSLY then siQueryStop must not be called.

Parameters

idp	Pointer to instance data.
pQueryData	Pointer to structure containing query details.
queryTarget	Handle to target of query (ie. object that needs query results - eg. carousel or section filter).
pResult	Results of query if synchronously returned.

Returns: CLDSM_OK Everything hunkydory CLDSM_ERR_SI_QUERY_FAILED Synchronous SI query failed to determine requested information CLDSM_MEM_HEAP_FULL Internal memory manager heap full (treat as internal error)

void siQueryStop	(	P_DsmCoreInst	idp,
		P_SiQuery	pSiQueryRef
	)

Stops the specified SI Query. Removes from any lists it is in and destroys associated memory object. NB. If siQueryStart returned results SYNCHRONOUSLY then this must not be called.

Parameters

idp	Pointer to instance data.
pSiQueryRef	Pointer to handle of query to stop (nulled after call).

Returns