Поделиться через


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

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

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

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

Синтаксис

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