putFeature Method

 

Sets the value of a SAX reader feature.

These features allow you to control the behavior of the SAX reader. Each feature uses a qualified Uniform Resource Identifier (URI) that identifies it to the reader.

Visual Basic Usage Syntax

oSAXXMLReader.putFeature
(strName, vfValue)  

Parameters

strName
The name of the current feature.

vfValue
A Boolean expression (True/False) specifying whether the feature is on or off.

Return Values

The following table shows the return values for the putFeature method.

Feature	Returns
exhaustive-errors  external-general-entities  external-parameter-entities  namespacesnamespace-prefixes  parameter-entities  preserve-system-identifiers  prohibit-dtd  schema-validation  server-http-request  suppress-validation-fatalError  use-inline-schema  use-schema-location	If failed, trappable error.
Other features	Trappable error

C/C++ Syntax

HRESULT putFeature(  
   [in] const wchar_t * pwchName,  
   [in] VARIANT_BOOL vfValue);  

Parameters

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

vfValue[in]
The current state of the feature (True or False).

Return Values

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

Feature	Returns
namespaces	S_OK (not parsing and legal) E_FAIL if namespace-prefixes is False. (parsing or illegal)
namespace-prefixes	S_OK (not parsing and legal) E_FAIL if namespaces is False. (parsing or illegal)
external-general-entities  external-parameter-entities  parameter-entities  preserve-system-identifiers  prohibit-dtd  suppress-validation-fatalError  use-inline-schema  use-schema-location	S_OK (not parsing) E_FAIL (parsing or illegal)
server-http-request	S_OK (not parsing) E_FAIL (parsing)
exhaustive-errrors  schema-validation	E_FAIL
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

getFeature Method