WsReadAttribute 関数 (webservices.h)

指定したWS_TYPEの値を生成する属性を読み取 ります。

構文

HRESULT WsReadAttribute(
  [in]           WS_XML_READER                  *reader,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_READ_OPTION                 readOption,
  [in, optional] WS_HEAP                        *heap,
                 void                           *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

パラメーター

[in] reader

属性を含む 要素に配置されるリーダー。

[in] attributeDescription

属性を逆シリアル化する方法の説明へのポインター。

[in] readOption

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

[in, optional] heap

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

value

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

[in] valueSize

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

[in, optional] error

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

戻り値

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

注釈

この API は、名前と名前空間を指定して 属性を検索し、入力された値としてコンテンツを逆シリアル化します。

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

要件