Función WsWriteArray (webservices.h)

Esta operación envía una serie de elementos a un objeto de escritura XML.

Sintaxis

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
);

Parámetros

[in] writer

Puntero al escritor donde se escriben los elementos.

[in] localName

Puntero al localName del elemento de repetición.

[in] ns

Puntero al espacio de nombres del elemento repetido.

[in] valueType

Tipo de valor para los elementos

array

Puntero void a los valores escritos en writer. El tamaño de los elementos viene determinado por tipo de valor.

[in] arraySize

Longitud total de bytes de la matriz.

[in] itemOffset

Desplazamiento del elemento dentro de la matriz que se va a escribir.

[in] itemCount

Número total de elementos que se van a escribir desde la matriz.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función es semánticamente equivalente al uso de WsWriteStartElement, WsWriteValue y WsWriteEndElement en un bucle, pero es más eficaz.

Requisitos