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


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

Эта функция возвращает пространство имен из префикса, к которому она привязана.

Если для обязательного параметра задано значение TRUE , а префикс не привязан ни к одному пространству имен, будет возвращено WS_E_INVALID_FORMAT исключение. (См. раздел Возвращаемые значения веб-служб Windows.) Если обязательный параметр имеет значение FALSE, а префикс не привязан ни к одному пространству имен, параметр ns будет иметь значение NULL , а функция вернет S_FALSE.

Синтаксис

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] reader

Указатель на средство чтения, по которому должен выполняться поиск префикса.

[in] prefix

Указатель на искомый префикс.

[in] required

Значение этого логического параметра определяет, следует ли возвращать ошибку, если соответствующее пространство имен не найдено.

ns

Ссылка на пространство имен, к которому при успешном выполнении привязан префикс. Возвращаемое значение допустимо только до тех пор, пока модуль записи не перейдет вперед.

[in, optional] error

Указатель на объект WS_ERROR , в котором должны храниться дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата Описание
WS_E_INVALID_FORMAT
Входные данные не были в ожидаемом формате или не имели ожидаемого значения.

Комментарии

Для префикса "xml" будет возвращено пространство имен "http://www.w3.org/XML/1998/namespace".

Для префикса "xmlns" возвращается пространство имен "http://www.w3.org/2000/xmlns/".

Требования

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