Функция WsGetMissingMetadataDocumentAddress (webservices.h)

Эта функция возвращает адрес отсутствующих документов, на который ссылается объект метаданных.

Каждый документ, добавляемый в объект метаданных, может содержать ссылки на другие документы. После добавления документа обратно в метаданные можно использовать функцию для поиска следующего отсутствующих документов.

Примечание Эта функция завершится ошибкой, если имя узла URL-адреса, возвращаемого отсутствующим, не может быть проверено как одно из ожидаемых имен узлов. Ожидаемые имена узлов представляют собой объединение следующих элементов:

• Имя узла любого URL-адреса, ранее переданного в WsReadMetadata.
• Список имен узлов, указанных с помощью свойства WS_METADATA_PROPERTY_HOST_NAMES .

 

Синтаксис

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

Параметры

[in] 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
Header	webservices.h
Библиотека	WebServices.lib
DLL	WebServices.dll