Funzione WsReadArray (webservices.h)

Articolo
08/27/2023

Legge una serie di elementi dal lettore e interpreta il contenuto in base al tipo di valore specificato.

Sintassi

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

Parametri

[in] reader

Lettore da cui deve essere letto la matrice.

[in] localName

LocalName dell'elemento ripetuto.

[in] ns

Spazio dei nomi dell'elemento ripetuto.

[in] valueType

Tipo di valore da usare per analizzare il contenuto di ogni elemento.

array

Matrice da popolare con valori analizzati. Le dimensioni degli elementi della matrice sono determinate dal tipo di valore. Per altre informazioni , vedere WS_VALUE_TYPE .

[in] arraySize

Dimensioni in byte (non elementi) della matrice.

[in] itemOffset

Offset dell'elemento (non byte) all'interno della matrice in cui leggere.

[in] itemCount

Numero di elementi (non byte) da leggere nella matrice.

[out] actualItemCount

Numero effettivo di elementi letti. Questo può essere minore di itemCount anche quando ci sono più elementi rimanenti. Non sono presenti più elementi quando questo restituisce zero.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori 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.
WS_E_QUOTA_EXCEEDED	È stata superata una quota.

Commenti

Questa funzione è semanticamente equivalente all'uso di WsReadStartElement, WsReadValue e WsReadEndElement in un ciclo, ma è più efficiente.

Questa funzione può non riuscire per uno dei motivi elencati in WsReadNode.

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

Share via