共用方式為

WsReadArray 函式 (webservices.h)

  • 發行項

從讀取器讀取一系列元素，並根據指定的實值型別來解譯其內容。

語法

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

參數

[in] reader

應從中讀取陣列的讀取器。

[in] localName

重複專案的localName。

[in] ns

重複專案的命名空間。

[in] valueType

用來剖析每個元素內容的實值型別。

array

要填入已剖析值的陣列。 數位專案的大小取決於實值類型。 如需詳細資訊 ，請參閱WS_VALUE_TYPE 。

[in] arraySize

以位元組為單位的大小， (不是陣列) 的專案。

[in] itemOffset

專案 (不是位元組) 陣列內要讀取的位移。

[in] itemCount

要讀取陣列的項目數 (不是位元組數) 。

[out] actualItemCount

已讀取的實際項目數目。 即使剩餘的專案越多，這也可能小於itemCount。 當這個 傳回零時，不會再有任何元素。

[in, optional] error

指定函式失敗時應該儲存其他錯誤資訊的位置。

傳回值

此函式可以傳回其中一個值。

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據的格式不正確，或沒有預期的值。
WS_E_QUOTA_EXCEEDED
 超過配額。

備註

此函式在語意上相當於在迴圈中使用 WsReadStartElement、 WsReadValue 和 WsReadEndElement ，但更有效率。

此函式可能會因為 WsReadNode 中列出的任何原因而失敗。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll