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

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

  • Статья

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

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

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

Если вызывается WsWriteStartElement , но элемент не зафиксирован, пространства имен и префиксы, на которые ссылается элемент, и любые атрибуты элемента недоступны для этой функции.

Синтаксис

HRESULT WsGetPrefixFromNamespace(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
                 const WS_XML_STRING **prefix,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] writer

Указатель на модуль записи с пространством имен для поиска. Это должен быть допустимый объект WS_XML_WRITER , возвращаемый WsCreateWriter , и не может иметь значение NULL.

[in] ns

Пространство имен для поиска.

[in] required

Указывает, следует ли возвращать ошибку, если соответствующий префикс не найден.

prefix

Ссылка на префикс, привязанный к пространству имен, или ЗНАЧЕНИЕ NULL , если значение обязательного параметра равно FALSE и соответствующее пространство имен не найдено.

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

 

[in, optional] error

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

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

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

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

Комментарии

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

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

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

Требования

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