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

перечисление WS_WRITE_OPTION (webservices.h)

  • Статья

Указывает, содержит ли указанное хранилище значение или указатель на значение, а также может ли значение быть представлено как nil в XML-содержимом.

Синтаксис

typedef enum {
  WS_WRITE_REQUIRED_VALUE = 1,
  WS_WRITE_REQUIRED_POINTER = 2,
  WS_WRITE_NILLABLE_VALUE = 3,
  WS_WRITE_NILLABLE_POINTER = 4
} WS_WRITE_OPTION;

Константы

 
WS_WRITE_REQUIRED_VALUE
Значение: 1
Указанное хранилище содержит значение. Размер хранилища
укажите размер значения.

Этот параметр указывает, что значение всегда записывается в XML-содержимое.


значение int;
Api(..., &значение, sizeof(value), ...);



всегда записывается
123


Этот параметр не поддерживается для типов указателей
(WS_WSZ_TYPE и WS_XML_BUFFER_TYPE).
Параметр WS_WRITE_REQUIRED_POINTER следует использовать для этих типов.
WS_WRITE_REQUIRED_POINTER
Значение: 2
Указанное хранилище содержит указатель на значение. Тем
Размер указанного хранилища всегда равен размеру указателя независимо от того,
типа, сериализованного.

Этот параметр указывает, что значение всегда записывается в XML-содержимое.


int* valuePointer; может не иметь значение NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



всегда записывается
123


Если указатель на значение, указанное в хранилище, null,
возвращается E_INVALIDARG.
(См. возвращаемые значения веб-служб Windows.)
WS_WRITE_NILLABLE_VALUE
Значение: 3
Указанное хранилище содержит указатель на значение. Тем
Размер указанного хранилища всегда равен размеру указателя независимо от того,
типа, сериализованного.

Если значение равно nil, элемент nil записывается в XML-содержимое.
Если нет, значение сериализуется обычно.


значение WS_STRING; может содержать значение nil (см. WS_STRING_TYPE)
Api(..., &значение, sizeof(value), ...);



Значение, отличное от nil
hello

Значение nil



Этот параметр поддерживается только для следующих типов, перечисленных ниже.
которые имеют встроенный способ представления значения nil. См. документацию
для каждого типа для получения сведений о том, как представлен nil.
WS_WRITE_NILLABLE_POINTER
Значение: 4
Для всех типов указанное хранилище содержит указатель на значение. Тем
Размер указанного хранилища всегда равен размеру указателя независимо от того,
типа, сериализованного.

Если указатель на значение, указанное в хранилище, NULL, то
Элемент nil записывается в XML-содержимое.


int* valuePointer; может иметь значение NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



Значение, отличное от NULL
123

Значение NULL

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 7 [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2008 R2 [классические приложения | Приложения UWP]
заголовка webservices.h