WsWriteValue-Funktion (webservices.h)

  • Artikel

Dieser Vorgang leitet die beste Darstellung für einen primitiven Wert von der zugrunde liegenden Codierung ab und übergibt den abgeleiteten Wert an ein Writer-Objekt.

Hinweis Es ist im Allgemeinen effizienter, diese Funktion zum Schreiben primitiver Werte zu verwenden, anstatt den Wert in Text zu konvertieren und anschließend WsWriteChars zu verwenden.

 

Syntax

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Ein Zeiger auf das WS_XML_WRITER -Objekt, in das der Wert geschrieben wird. Der Zeiger muss auf ein gültiges XML Writer-Objekt verweisen.

[in] valueType

Gibt den Typ des primitiven Werts an, auf den vom value-Parameter verwiesen wird.

I

value

Ein void-Zeiger auf den primitiven Wert.

[in] valueSize

Die Größe des geschriebenen Werts in Byte.

[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
 Mindestens ein Argument ist ungültig.
WS_E_INVALID_OPERATION
 Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.

Hinweise

WsWriteValue kann nur einmal zwischen WsWriteStartAttribute und WsWriteEndAttribute aufgerufen werden. Sie kann beim Schreiben eines Attributs nicht mit WsWriteChars, WsWriteBytes, WsWriteCharsUtf8 oder WsWriteText kombiniert werden.

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