getFeature Method

  • Article

 

Returns the Boolean value of a SAX reader feature.

The Boolean value indicates if a feature is enabled or disabled. For example, setting the "http://xml.org/sax/features/namespaces" feature to True enables namespace processing during parsing.

Visual Basic Usage Syntax

strFeature = oSAXXMLReader.getFeature
(strName)

Parameters

strName
The name of the current feature.

The feature name is any fully-qualified Uniform Resource Identifier (URI). The values for the namespaces and namespace-prefixes features may be available only in a specific context, such as before, during, or after a parse.

Return Values

For any currently implemented feature of the SAX reader, returns the value of the feature. If a feature is named which is not currently implemented by the SAX reader, returns a trappable error.

C/C++ Syntax

HRESULT getFeature(  
   [in] const wchar_t * pwchName,  
   [out, retval] VARIANT_BOOL * pvfValue);

Parameters

pwchName[in]
The feature name (zero-terminated Unicode string).

pvfValue[out, retval]
The value of the feature (True or False).

Return Values

The following table lists the return values for the getFeature method.

Feature Returns
exhaustive-errors

 external-general-entities

 external-parameter-entities

 namespaces

 namespace-prefixes

 parameter-entities

 preserve-system-identifiers

 prohibit-dtd

 server-http-request

 suppress-validation-fatalError

 use-inline-schema

 use-schema-location		 S_OK — Last successful putFeature argument.
schema-validation S_OK — False
Other features E_INVALIDARG

Remarks

For more information on specific features, see SAX Reader Features.

Versioning

Implemented in: MSXML 3.0 and later

Applies to

ISAXXMLReader Interface

See Also

putFeature Method