WsFindAttribute-Funktion (webservices.h)

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