getValueFromQName Method

 

Finds the attribute by XML 1.0 qualified name and returns the attribute's text value.

Visual Basic Implementation Syntax

Function getValueFromQName(ByVal strQName As String) As String  

Visual Basic Usage Syntax

StrValue = oIVBSAXAttributes.getValueFromQName
(strQName)  

Parameters

strQName
The XML 1.0 qualified name.

Return Values

If failed, raises a trappable error.

C/C++ Syntax

HRESULT getValueFromQName(  
   [in] const wchar_t * pwchQName,   
   [in] int cchQName,   
   [out] const wchar_t ** pwchValue,  
   [out] int * pcchValue);  

Parameters

pwchQName[in]
The XML 1.0 qualified name.

cchQName[in]
The length of the qualified name string.

pwchValue[out]
The string value of the qualified name. ppwchValue should not be modified or deleted, because this can cause undefined behavior in the SAX parser. If you want to preserve the value that was returned in ppwchValue, you should make a deep copy.

pcchValue[out]
The length of the qualified name.

Return Values

S_OK
The value returned if the text value is returned successfully.

E_INVALIDARG
The value returned for an invalid index or if no matching attribute is found.

E_FAIL
The value returned if an internal error occurs.

Versioning

Implemented in: MSXML 3.0 and later

Applies to

ISAXAttributes Interface

See Also

getLength Method (C-C++)
length Property (Visual Basic)