次の方法で共有

WsGetMissingMetadataDocumentAddress 関数 (webservices.h)

  • [アーティクル]

この関数は、メタデータ オブジェクトによって参照されている不足しているドキュメントのアドレスを返します。

メタデータ オブジェクトに追加される各ドキュメントには、他のドキュメントへの参照が含まれている場合があります。 ドキュメントをメタデータに追加し直した後、関数を使用して、不足している次のドキュメントを見つけることができます。

メモ 返される不足しているアドレスの URL のホスト名を、想定されるホスト名の 1 つとして検証できない場合、この関数は失敗します。 想定されるホスト名は、次の和集合です。
 

構文

HRESULT WsGetMissingMetadataDocumentAddress(
  [in]           WS_METADATA         *metadata,
                 WS_ENDPOINT_ADDRESS **address,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] metadata

このパラメーターは、ドキュメントを持つ必要がある Metadata オブジェクトへのポインターです。

address

成功すると、このパラメーターには、不足しているメタデータ ドキュメントのアドレスへのポインターが設定されます。不足しているメタデータ ドキュメントがない場合は NULL が 設定されます。

返されるアドレス URL は完全修飾です。

メモ この関数によって返されるデータは、メタデータ オブジェクトが解放またはリセットされるまで有効です。 データは変更しないでください。
 

[in, optional] error

このパラメーター は、関数 が失敗した場合にエラーに関する追加情報を格納する必要があるへのWS_ERROR ポインターです。

戻り値

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

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。
E_OUTOFMEMORY
 メモリ不足。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

解説

この関数で返される URL のホスト名を確認するかどうかは、 WS_METADATA_PROPERTY_VERIFY_HOST_NAMES 列挙子値を使用して制御できます。

ホスト名の検証の目的は、アプリケーションがメタデータを受け入れるホストからのものであることを知らずにアドレスを使用しないようにすることです。

要件

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