Funzione WsWriteType (webservices.h)

Articolo
03/03/2024

Scrivere un valore di un determinato WS_TYPE in XML in base al WS_TYPE_MAPPING.

Sintassi

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parametri

[in] writer

Writer in cui scrivere il valore.

[in] typeMapping

Viene descritto il mapping del tipo al codice XML in fase di scrittura.

[in] type

Tipo del valore da serializzare.

[in, optional] typeDescription

Informazioni aggiuntive sul tipo. Ogni tipo ha una struttura di descrizione diversa. Può trattarsi di NULL, a seconda del WS_TYPE.

[in] writeOption

Indica se il valore è obbligatorio e la modalità di allocazione del valore. Per altre informazioni, vedere WS_WRITE_OPTION .

Questo parametro deve avere uno dei valori seguenti:

value

Puntatore al valore da serializzare.

[in] valueSize

Dimensione del valore da serializzare.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore 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.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Per informazioni su come usare questa funzione per scrivere valori in elementi e attributi, vedere WS_TYPE_MAPPING .

Se l'API non riesce, lo stato del writer di input diventa indefinito. Le uniche API che possono essere usate nel writer se si verifica sono WsSetOutput e WsSetOutputToBuffer per restituire il writer a uno stato utilizzabile o WsFreeWriter per liberare il writer.

Requisiti

Requisito	Valore
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