Share via

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 より小さい場合があります。 これが 0 を返すときに、それ以上の要素はありません。

[in, optional] error

関数が失敗した場合に追加のエラー情報を格納する場所を指定します。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
WS_E_INVALID_FORMAT
 入力データの形式が正しくないか、予期した値が指定されていませんでした。
WS_E_QUOTA_EXCEEDED
 クォータを超えました。

注釈

この関数は、WsReadStartElement、WsReadValue、および WsReadEndElement をループ内で使用することと意味的に同じですが、より効率的です。

この関数は、 WsReadNode に記載されている任意の理由で失敗する可能性があります。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー webservices.h
Library WebServices.lib
[DLL] WebServices.dll