WsFindAttribute-Funktion (webservices.h)

  • Artikel

Durchsucht die Attribute des aktuellen Elements nach einem Attribut mit dem angegebenen Namen und Namespace und gibt seinen Index zurück, der an WsReadStartAttribute übergeben werden kann.

Syntax

HRESULT WsFindAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
  [out]          ULONG               *attributeIndex,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] reader

Der Leser, auf dem das Attribut gefunden werden soll.

[in] localName

Der lokale Name des attributs, nach dem gesucht werden soll.

[in] ns

Der Namespace des attributs, nach dem gesucht werden soll.

[in] required

Wenn erforderlich true ist und das Attribut nicht gefunden wird, gibt die Funktion WS_E_INVALID_FORMAT zurück. (Siehe Rückgabewerte für Windows-Webdienste.) wenn erforderlich false ist und das Attribut nicht gefunden wird, gibt die Funktion S_FALSE zurück.

[out] attributeIndex

Wenn das Attribut gefunden wird, wird hier der Index des Attributs zurückgegeben. Dieser Index kann dann an WsReadStartAttribute übergeben werden.

[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
WS_E_INVALID_FORMAT
 Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.

Hinweise

Wenn der Leser nicht auf einem Startelement positioniert ist, wird WS_E_INVALID_OPERATION zurückgegeben. (Siehe Rückgabewerte für Windows-Webdienste.)

Der zurückgegebene Index entspricht nicht unbedingt der Position des Attributs, wie er im Dokument angezeigt wurde. Er identifiziert den Index des übereinstimmenden Attributs im Array der Attribute des WS_XML_ELEMENT_NODE. Die Reihenfolge der Attribute in diesem Array kann von der Reihenfolge abweichen, in der die Attribute im Dokument angezeigt wurden.

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