MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 1067 / 1108

CCFXRequest class 1067
CCFXRequest::GetCustomData
Syntax
LPVOID CCFXRequest::GetCustomData(void)
Description
Gets the custom (tag specific) data for the request. This method is typically used from within
subroutines of a tag implementation to extract tag data from a request.
Returns
Returns a pointer to the custom data, or
NULL
if no custom data has been set during this request
using
CCFXRequest::SetCustomData
.
Example
The following example retrieves a pointer to a request specific data structure of hypothetical type
MYTAGDATA:
void DoSomeGruntWork( CCFXRequest* pRequest )
{
MYTAGDATA* pTagData =
(MYTAGDATA*)pRequest->GetCustomData() ;
... remainder of procedure ...
}
CCFXRequest::GetQuery
Syntax
CCFXQuery* CCFXRequest::GetQuery(void)
Description
Retrieves a query that was passed to a tag. To pass a query to a custom tag, you use the
QUERY
attribute. This attribute should be set to the name of a query (created using the
cfquery
tag or
another custom tag). The
QUERY
attribute is optional and should be used only by tags that process
an existing data set.
Returns
Returns an object of the
CCFXQuery class
that represents the query passed to the tag. If no
query was passed to the tag,
NULL
is returned. The memory allocated for the returned query is
freed automatically by ColdFusion after the request is completed.