WsWriteArray 函式 (webservices.h)

這項作業會將一系列專案傳送至 XML 寫入器。

語法

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

參數

[in] writer

寫入專案的寫入器指標。

[in] localName

重複專案的localName指標。

[in] ns

重複專案的命名空間指標。

[in] valueType

項目的實值型別

array

寫入器之值的 void 指標。 專案的大小取決於實值類型。

注意 如需詳細資訊 ，請參閱WS_VALUE_TYPE 。

 

[in] arraySize

陣組的總位元組長度。

[in] itemOffset

要寫入之陣列內的專案位移。

[in] itemCount

要從數位寫入的項目總數。

[in, optional] error

WS_ERROR 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

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

規格需求

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