IARGlobe.SearchARFeatures Method

Searches the globe using a search definition and returns an ARFeatureCursor.

[Visual Basic .NET]
Public Function SearchARFeatures ( _
    ByVal pSearchDef As ArcReaderSearchDef _
) As ARFeatureCursor

[C#]
public ARFeatureCursor SearchARFeatures (
    ArcReaderSearchDef pSearchDef
);

Product Availability

Description

Searches the ARGlobe based upon an attribute or spatial query as defined by the ARSearchDef. Only ARLayer objects with a Searchable property set to true within the ARGlobe will be searched.

Use the ARFeatureCursor to retrieve each ARFeature one at a time. If there are no ARFeature objects matching the query the first call to IARFeatureCursor::NextARFeature will return nothing.

Errors Returned

2029 800A07ED: Unitialized search definition
2034 800A07F2: The query has failed
2113 800A0841: The current document does not have permission to query features

Remarks

The SearchARFeatures method will return an error if the currently loaded document was not published with permission to QueryFeatures. Use the IARControl::HasDocumentPermission method to determine this.
If there is an error with the query, such as ill-formed SQL, the error returned will contain an error description from the underlying database.

See Also