次の方法で共有

WsReadType 関数 (webservices.h)

  • [アーティクル]

WS_TYPE_MAPPINGに従って、XML から特定のWS_TYPEの値を読み取ります。

構文

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

パラメーター

[in] reader

逆シリアル化する XML 上に配置されているリーダー。

[in] typeMapping

型が読み取られている XML にマップされる方法について説明します。

[in] type

逆シリアル化する値の型。

[in, optional] typeDescription

型に関する追加情報。 各型には、異なる説明構造があります。 これは、WS_TYPEによっては NULL になる場合があります。

[in] readOption

値が必要かどうか、および値を割り当てる方法。 詳細については、「 WS_READ_OPTION 」を参照してください。

このパラメーターには、次のいずれかの値が必要です。

[in, optional] heap

逆シリアル化された値を格納するヒープ。

value

このパラメーターの解釈は 、WS_READ_OPTIONによって異なります。

[in] valueSize

このパラメーターの解釈は 、WS_READ_OPTIONによって異なります。

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_E_INVALID_FORMAT
 入力データが予期された形式でなかったか、予期された値を持っていませんでした。
E_OUTOFMEMORY
 メモリが不足しました。
WS_E_QUOTA_EXCEEDED
 ヒープのサイズ クォータを超えました。
E_INVALIDARG
 1 つ以上の引数が無効です。

注釈

この関数を使用して要素と属性から値を読み取る方法については、「 WS_TYPE_MAPPING 」を参照してください。

API が失敗した場合、入力リーダーの状態は未定義になります。 リーダーで使用できる API は、リーダーを使用可能な状態に戻すために WsSetInput と WsSetInputToBuffer だけです。リーダーを解放するには WsFreeReader だけです。

要件

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