WsGetXmlAttribute-Funktion (webservices.h)

  • Artikel

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.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
S_FALSE
 Das xml-Attribut wurde nicht gefunden.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll