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

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

  • Статья

Считывает элемент Metadata и добавляет его в документы метаданных объекта Metadata.

Для объекта метаданных необходимо задать состояние WS_METADATA_STATE_CREATED.

При ошибке состояние объекта метаданных сбрасывается до 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 , используемый для чтения метаданных. Указатель должен ссылаться на допустимый объект WS_XML_READER , а средство чтения должно располагаться на элементе, содержавав нужные метаданные.

[in] url

Указатель на объект WS_STRING , ссылающийся на URL-адрес извлеченных метаданных. 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

Два базовых 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
 Один или несколько аргументов недопустимы.
S_FALSE
 Элемент не был использован.
Другие ошибки
Эта функция может возвращать другие ошибки, не перечисленные выше.

Комментарии

Эта функция распознает следующие типы метаданных:

  • Документы WSDL 1.1
  • документы WS-Policy версии 1.2

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll