Funzione WsWriteArray (webservices.h)

Articolo
03/13/2024

Questa operazione invia una serie di elementi a un writer XML.

Sintassi

HRESULT WsWriteArray(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 const void          *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [in, optional] WS_ERROR            *error
);

Parametri

[in] writer

Puntatore al writer in cui vengono scritti gli elementi.

[in] localName

Puntatore al nome locale dell'elemento ripetuto.

[in] ns

Puntatore allo spazio dei nomi dell'elemento ripetuto.

[in] valueType

Tipo di valore per gli elementi

array

Puntatore void ai valori scritti nel writer. Le dimensioni degli elementi sono determinate dal tipo di valore.

Nota Per altre informazioni , vedere WS_VALUE_TYPE .

[in] arraySize

Lunghezza totale di byte della matrice.

[in] itemOffset

Offset dell'elemento all'interno della matrice da scrivere.

[in] itemCount

Numero totale di elementi da scrivere dalla matrice.

[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

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione è semanticamente equivalente all'uso di WsWriteStartElement, WsWriteValue e WsWriteEndElement in un ciclo, ma è più efficiente.

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