putFeature Method

  • Article

 

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