Função WsReadArray (webservices.h)

Lê uma série de elementos do leitor e interpreta seu conteúdo de acordo com o tipo de valor especificado.

Sintaxe

HRESULT WsReadArray(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 void                *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [out]          ULONG               *actualItemCount,
  [in, optional] WS_ERROR            *error
);

Parâmetros

[in] reader

O leitor do qual a matriz deve ser lida.

[in] localName

O localName do elemento de repetição.

[in] ns

O namespace do elemento de repetição.

[in] valueType

O tipo de valor a ser usado para analisar o conteúdo de cada elemento.

array

A matriz a ser preenchida com valores analisados. O tamanho dos itens de matriz é determinado pelo tipo de valor. Consulte WS_VALUE_TYPE para obter mais informações.

[in] arraySize

O tamanho em bytes (não itens) da matriz.

[in] itemOffset

O deslocamento do item (não byte) dentro da matriz na qual ler.

[in] itemCount

O número de itens (não bytes) a serem lidos na matriz.

[out] actualItemCount

O número real de itens que foram lidos. Isso pode ser menor que itemCount mesmo quando há mais itens restantes. Não há mais elementos quando isso retorna zero.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Comentários

Essa função é semanticamente equivalente ao uso de WsReadStartElement, WsReadValue e WsReadEndElement em um loop, mas é mais eficiente.

Essa função pode falhar por qualquer um dos motivos listados no WsReadNode.

Requisitos