Compartilhar via

Função WsWriteArray (webservices.h)

  • Artigo

Essa operação envia uma série de elementos para um Gravador XML.

Sintaxe

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

Um ponteiro para o Gravador em que os elementos são gravados.

[in] localName

Um ponteiro para o localName do elemento de repetição.

[in] ns

Um ponteiro para o namespace do elemento de repetição.

[in] valueType

O tipo de valor para os elementos

array

Um ponteiro nulo para os valores gravados no gravador. O tamanho dos itens é determinado pelo tipo de valor.

Nota Consulte WS_VALUE_TYPE para obter mais informações.

 

[in] arraySize

O comprimento total de bytes da matriz.

[in] itemOffset

O deslocamento de item dentro da matriz a ser gravada.

[in] itemCount

O número total de itens a serem gravados da matriz.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função é semanticamente equivalente ao uso de WsWriteStartElement, WsWriteValue e WsWriteEndElement em um loop, mas é mais eficiente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll