WsGetReaderProperty-Funktion (webservices.h)

Artikel
08/27/2023

Diese Funktion gibt eine Eigenschaft des angegebenen XML-Readers zurück.

Hinweis Zum Abrufen der Eigenschaft WS_XML_READER_PROPERTY_CHARSET müssen bis zu den ersten vier Bytes der XML-Daten überprüft werden. Wenn der Reader WS_XML_READER_STREAM_INPUT muss daher zuerst die WsFillReader-Funktion aufgerufen werden, um sicherzustellen, dass diese Daten gelesen wurden.

Syntax

HRESULT WsGetReaderProperty(
  [in]           WS_XML_READER             *reader,
  [in]           WS_XML_READER_PROPERTY_ID id,
                 void                      *value,
  [in]           ULONG                     valueSize,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] reader

Ein Zeiger auf ein WS_XML_READER-Objekt, das den gewünschten Eigenschaftswert enthält.

[in] id

Ein Enumeratorwertbezeichner der Reader-Eigenschaft.

value

Ein Zeiger auf die Adresse zum Zurückgeben des abgerufenen Werts. Der Zeiger muss über eine Ausrichtung verfügen, die mit dem Typ der Eigenschaft kompatibel ist.

[in] valueSize

Eine Byteanzahl des Puffers, den der Aufrufer für den abgerufenen Wert zugeordnet hat.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Die Eigenschafts-ID wurde für dieses Objekt nicht unterstützt, oder der angegebene Puffer war nicht groß genug für den Wert.

Anforderungen


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