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

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

  • Статья

Считывает расширение WS_ENDPOINT_ADDRESS.

Синтаксис

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

Параметры

[in] reader

Средство чтения XML, используемое для чтения расширения.

Функция автоматически задаст входные данные средства чтения, необходимые для чтения расширений.

[in] endpointAddress

Адрес конечной точки, содержащий расширения.

[in] extensionType

Тип считываемого расширения.

[in] readOption

Является ли значение обязательным и как его выделить. Дополнительные сведения см. в разделе WS_READ_OPTION .

Этот параметр должен иметь одно из следующих значений:

[in] heap

Куча, используемая для хранения считываемого значения.

value

Адрес буфера для размещения считываемого значения.

При использовании WS_READ_REQUIRED_VALUE для параметра readOption буфер должен быть размером считываемого расширения (который зависит от WS_ENDPOINT_ADDRESS_EXTENSION_TYPE).

При использовании WS_READ_REQUIRED_POINTER или WS_READ_OPTIONAL_POINTER буфер должен иметь размер указателя.

[in] valueSize

Размер буфера, выделенного вызывающим объектом для считываемого значения.

Этот размер должен соответствовать размеру буфера, переданного с помощью параметра value.

[in, optional] error

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

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

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

Код возврата Описание
E_INVALIDARG
 Недопустимый тип расширения.

Неправильный размер предоставленного буфера.

Обязательный параметр имеет значение NULL.
WS_E_INVALID_FORMAT
 Входные данные не были в ожидаемом формате или не имели ожидаемого значения.
E_OUTOFMEMORY
 Не хватает памяти.
Другие ошибки
Эта функция может возвращать другие ошибки, не перечисленные выше.

Комментарии

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

Если запрошенный тип расширения отображается в буфере расширений несколько раз, возвращается первый экземпляр.

Требования

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