Funzione WsWriteValue (webservices.h)

Articolo
08/27/2023

Questa operazione deriva la rappresentazione migliore per un valore primitivo dalla codifica sottostante e passa il valore derivato a un oggetto Writer.

Nota In genere è più efficiente usare questa funzione per scrivere valori primitivi anziché convertire il valore in testo e successivamente usare WsWriteChars.

Sintassi

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

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER in cui viene scritto il valore. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

[in] valueType

Indica il tipo di valore primitivo a cui fa riferimento il parametro value .

value

Puntatore void al valore primitivo.

[in] valueSize

Dimensione in byte del valore scritto.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
WS_E_INVALID_OPERATION	L'operazione non è consentita a causa dello stato corrente dell'oggetto .

Commenti

WsWriteValue può essere chiamato una sola volta tra WsWriteStartAttribute e WsWriteEndAttribute. Non può essere combinato con WsWriteChars, WsWriteBytes, WsWriteCharsUtf8 o WsWriteText durante la scrittura di un attributo.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Share via