Compartilhar via

WS_WRITE_OPTION enumeração (webservices.h)

  • Artigo

Especifica se um armazenamento especificado contém o valor ou um ponteiro para o valor e se o valor pode ser representado como nulo no conteúdo XML.

Sintaxe

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;

Constantes

 
WS_WRITE_REQUIRED_VALUE
Valor: 1
O armazenamento especificado contém o valor. O tamanho do armazenamento
especificado deve ser o tamanho do valor.

Essa opção especifica que o valor sempre será gravado no conteúdo XML.


valor int;
Api(..., &valor, sizeof(value), ...);



sempre escrito
123


Essa opção não tem suporte para tipos de ponteiro
(WS_WSZ_TYPE e WS_XML_BUFFER_TYPE).
A opção WS_WRITE_REQUIRED_POINTER deve ser usada para esses tipos.
WS_WRITE_REQUIRED_POINTER
Valor: 2
O armazenamento especificado contém um ponteiro para o valor. O
o tamanho do armazenamento especificado é sempre o tamanho de um ponteiro, independentemente
do tipo que está sendo serializado.

Essa opção especifica que o valor sempre será gravado no conteúdo XML.


int* valuePointer; pode não ser NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



sempre escrito
123


Se o ponteiro para o valor especificado no armazenamento for NULL,
E_INVALIDARG é retornado.
(Consulte Valores retornados dos Serviços Web do Windows.)
WS_WRITE_NILLABLE_VALUE
Valor: 3
O armazenamento especificado contém um ponteiro para o valor. O
o tamanho do armazenamento especificado é sempre o tamanho de um ponteiro, independentemente
do tipo que está sendo serializado.

Se o valor for nulo, um elemento zero será escrito no conteúdo XML.
Se não for nulo, o valor será serializado normalmente.


WS_STRING valor; pode conter um valor nulo (consulte WS_STRING_TYPE)
Api(..., &valor, sizeof(value), ...);



se o valor não for nulo
olá

se o valor for nulo



Essa opção só tem suporte para os seguintes tipos, listados abaixo,
que têm uma maneira intrínseca de representar um valor nulo. Consulte a documentação
para cada tipo para obter informações sobre como zero é representado.
WS_WRITE_NILLABLE_POINTER
Valor: 4
Para todos os tipos, o armazenamento especificado contém um ponteiro para o valor. O
o tamanho do armazenamento especificado é sempre o tamanho de um ponteiro, independentemente
do tipo que está sendo serializado.

Se o ponteiro para o valor especificado no armazenamento for NULL, em seguida,
um elemento nulo é escrito no conteúdo XML.


int* valuePointer; pode ser NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



se o valor não for NULL
123

se o valor for NULL

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
cabeçalho webservices.h