WsGetMissingMetadataDocumentAddress 函数 (webservices.h)

  • 项目

此函数返回元数据对象引用的缺失文档的地址。

添加到元数据对象的每个文档可能包含对其他文档的引用。 将文档添加回元数据后，函数可用于查找下一个缺失的文档。

注意 如果返回的缺失地址的 URL 的主机名无法验证为预期的主机名之一，则此函数将失败。 预期的主机名是以下各项的联合：
 

语法

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
 一个或多个参数无效。
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