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 |
---|---|
|
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 |