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

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

  • Статья

Записывает полное имя XML в модуль записи.

Синтаксис

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] writer

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

[in, optional] prefix

Указатель WS_XML_STRING на префикс, используемый полным именем. Если значение, на которое ссылается этот параметр, равно NULL , модуль записи выберет префикс.

[in] localName

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

[in, optional] ns

Указатель WS_XML_STRING на пространство имен, используемое для полного имени.

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

Если указан префикс, модуль записи использует этот префикс и при необходимости может включать атрибут XMLNS для переопределения существующего префикса в область.

[in, optional] error

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

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

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

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

Комментарии

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

    (См. раздел Возвращаемые значения веб-служб Windows.)

  • Если префикс не равен NULL , а пространство имен не равно NULL , модуль записи проверит, что префикс в данный момент привязан к указанному пространству имен, и вернет WS_E_INVALID_FORMAT , если нет.
  • Если префикс не равен NULL , а пространство имен равно NULL , модуль записи будет использовать префикс и локальное имя для записи полного имени.

Требования

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