次の方法で共有

WsReadMetadata 関数 (webservices.h)

  • [アーティクル]

Metadata 要素を読み取り、Metadata オブジェクトの Metadata ドキュメントに追加します。

Metadata オブジェクトの状態は 、WS_METADATA_STATE_CREATEDに設定する必要があります。

エラーが発生すると、Metadata オブジェクトの状態が WS_METADATA_STATE_FAULTEDにリセットされます。

メモ 要素にメタデータが含まれている場合、関数は 要素を使用します。 要素がメタデータを含んでいると認識されない場合、または特定の種類のメタデータが必要ない場合、要素は読み取りません。
 

構文

HRESULT WsReadMetadata(
  [in]           WS_METADATA     *metadata,
  [in]           WS_XML_READER   *reader,
  [in]           const WS_STRING *url,
  [in, optional] WS_ERROR        *error
);

パラメーター

[in] metadata

読み取られた メタデータ を格納するための Metadata オブジェクトへのポインター。 ポインターは、有効な WS_METADATA オブジェクトを参照する必要があります。

[in] reader

メタデータの読み取りに使用される XML Reader オブジェクトへのポインター。 ポインターは有効な WS_XML_READER オブジェクトを参照する必要があり、リーダーは目的のメタデータを含む要素に配置する必要があります。

[in] url

取得したメタデータ URL を参照 するWS_STRING オブジェクトへのポインター。 URL は、ドキュメント間の URL ベースのリンクを解決するためのメタデータ ドキュメントを追跡するために使用されます。

メモ URL は完全修飾である必要があります。 URL にはフラグメント識別子を指定できます。
 

次の URL スキームがサポートされています。

  • WS_URL_HTTP_SCHEME_TYPE
  • WS_URL_HTTPS_SCHEME_TYPE
  • WS_URL_NETTCP_SCHEME_TYPE
この関数を使用して指定する各 URL には、一意のベース URL が必要です。 ベース URL は、指定された URL からフラグメント識別子を削除することによって計算されます。

たとえば、次の URL が指定されている場合は、次のようになります。


http://example.com/document1#fragment
http://example.com/document2

2 つの基本 URL は次のようになります。


http://example.com/document1
http://example.com/document2

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_E_INVALID_FORMAT
 入力データの形式が正しくないか、予期した値が指定されていませんでした。
WS_E_INVALID_OPERATION
 オブジェクトの現在の状態のため、操作は許可されません。
WS_E_QUOTA_EXCEEDED
 クォータを超えました。
E_OUTOFMEMORY
 メモリ不足。
E_INVALIDARG
 1 つ以上の引数が無効です。
S_FALSE
 要素が使用されませんでした。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

この関数は、次の種類のメタデータを認識します。

  • WSDL 1.1 ドキュメント
  • WS-Policy 1.2 ドキュメント

要件

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