WsGetXmlAttribute-Funktion (webservices.h)

Sucht das nächstgelegene XML-Attribut im Bereich mit dem angegebenen localName und gibt seinen Wert zurück.
Der zurückgegebene Wert wird auf dem angegebenen Heap platziert.

Syntax

HRESULT WsGetXmlAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           WS_HEAP             *heap,
                 WCHAR               **valueChars,
  [out]          ULONG               *valueCharCount,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] reader

Der Reader, nach dem das XML-Attribut gesucht wird.

[in] localName

Der localName des xml-Attributs, nach dem gesucht werden soll.

[in] heap

Der Heap, auf dem der resultierende Wert zugeordnet werden soll.

valueChars

Der Wert des Attributs wird hier gespeichert.

[out] valueCharCount

Die Länge von valueChars.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Hinweise

Diese Funktion kann nur verwendet werden, um die Werte von Attributen im Bereich abzurufen, die das Präfix "xml" verwenden.

Wenn kein übereinstimmende XML-Attribut gefunden wird, wird eine Zeichenfolge der Länge Null für den Wert zurückgegeben, und die Funktion gibt S_FALSE zurück.

Der Reader führt nichts mit XML-Attributen aus, außer sie zur Überprüfung anzuzeigen.

Anforderungen