WsSetReaderPosition 関数 (webservices.h)

  • [アーティクル]

リーダーの現在位置を設定します。 位置は、WsGetReaderPosition または WsGetWriterPosition の呼び出しによって取得されている必要があります。

この関数は、 WS_XML_BUFFERに設定されているリーダーでのみ使用できます。

構文

HRESULT WsSetReaderPosition(
  [in]           WS_XML_READER              *reader,
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

パラメーター

[in] reader

現在の位置が設定されている WS_XML_READER オブジェクトへのポインター。 ポインターは、有効な XML リーダー オブジェクトを参照する必要があります。

[in] nodePosition

リーダーを設定する位置へのポインター。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

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

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。
WS_E_INVALID_OPERATION
 オブジェクトの現在の状態のため、操作は許可されません。

注釈

位置 の 使用の詳細については、「WS_XML_NODE_POSITION」を参照してください。

正規化中は、この関数を使用できません。 WsStartReaderCanonicalization が呼び出された場合は、WS_E_INVALID_OPERATIONが返されます。 ( 「Windows Web サービスの戻り値」を参照してください)。

要件

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