Condividi tramite


Funzione WsWriteValue (webservices.h)

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 .

I

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