Funzione WsWriteAttribute (webservices.h)

Articolo
03/15/2023

Scrivere un valore tipizzato come attributo XML.

Sintassi

HRESULT WsWriteAttribute(
  [in]           WS_XML_WRITER                  *writer,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_WRITE_OPTION                writeOption,
                 const void                     *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

Parametri

[in] writer

Writer in cui scrivere l'attributo.

[in] attributeDescription

Puntatore a una descrizione di come serializzare l'attributo.

[in] writeOption

Informazioni sulla modalità di allocazione del valore. Per altre informazioni , vedere WS_WRITE_OPTION .

value

Puntatore al valore da serializzare.

[in] valueSize

Dimensioni del valore serializzato, in byte.

Se il valore è NULL, le dimensioni devono essere 0.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Questa API scrive l'attributo start, il valore dell'attributo e l'attributo end.

Se l'API ha esito negativo, lo stato del writer di input non viene definito. L'unica API che può essere usata nel writer se si verifica è WsSetOutput e WsSetOutputToBuffer per restituire il writer a uno stato utilizzabile o WsFreeWriter per liberare il writer.

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

Condividi tramite