次の方法で共有

WsReadEndpointAddressExtension 関数 (webservices.h)

  • [アーティクル]

WS_ENDPOINT_ADDRESSの拡張機能を読 み取ります。

構文

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

パラメーター

[in] reader

拡張機能の読み取りに使用する XML リーダー。

関数は、拡張機能を読み取るために必要に応じてリーダーの入力を自動的に設定します。

[in] endpointAddress

拡張機能を含むエンドポイント アドレス。

[in] extensionType

読み取る拡張機能の種類。

[in] readOption

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

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

[in] heap

読み取られた値を格納するために使用するヒープ。

value

値を読み取るバッファーのアドレス。

readOption パラメーター にWS_READ_REQUIRED_VALUE を使用する場合、バッファーは読み取る拡張機能の種類のサイズである必要があります ( WS_ENDPOINT_ADDRESS_EXTENSION_TYPEによって異なります)。

WS_READ_REQUIRED_POINTERまたはWS_READ_OPTIONAL_POINTERを使用する場合、バッファーはポインターのサイズである必要があります。

[in] valueSize

呼び出し元が読み取った値に割り当てたバッファーのサイズ。

このサイズは、value パラメーターを使用して渡されるバッファーのサイズに対応している必要があります。

[in, optional] error

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

戻り値

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

リターン コード 説明
E_INVALIDARG
 拡張機能の種類が無効です。

指定されたバッファーのサイズが正しくありません。

必要なパラメーターが NULL でした。
WS_E_INVALID_FORMAT
 入力データの形式が正しくないか、予期した値が指定されていませんでした。
E_OUTOFMEMORY
 メモリ不足。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

戻り値は、ヒープが解放またはリセットされるまで有効です。

要求された拡張機能の種類が拡張機能バッファーに複数回表示される場合は、最初のインスタンスが返されます。

要件

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