Condividi tramite

enumerazione WS_WRITE_OPTION (webservices.h)

  • Articolo

Specifica se un archivio specificato contiene il valore o un puntatore al valore e se il valore può essere rappresentato come nil nel contenuto XML.

Sintassi

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;

Costanti

 
WS_WRITE_REQUIRED_VALUE
Valore: 1
Lo spazio di archiviazione specificato contiene il valore . Dimensioni dello spazio di archiviazione
specificato deve essere la dimensione del valore.

Questa opzione specifica che il valore verrà sempre scritto nel contenuto XML.


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



sempre scritto
123


Questa opzione non è supportata per i tipi di puntatore
(WS_WSZ_TYPE e WS_XML_BUFFER_TYPE).
L'opzione WS_WRITE_REQUIRED_POINTER deve essere usata per questi tipi.
WS_WRITE_REQUIRED_POINTER
Valore: 2
L'archiviazione specificata contiene un puntatore al valore . Le
le dimensioni dello spazio di archiviazione specificato sono sempre le dimensioni di un puntatore, indipendentemente dal fatto che
del tipo da serializzare.

Questa opzione specifica che il valore verrà sempre scritto nel contenuto XML.


int* valuePointer; potrebbe non essere NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



sempre scritto
123


Se il puntatore al valore specificato nell'archiviazione è NULL,
E_INVALIDARG viene restituito.
Vedere i valori restituiti di Servizi Web Windows.)
WS_WRITE_NILLABLE_VALUE
Valore: 3
L'archiviazione specificata contiene un puntatore al valore . Le
le dimensioni dello spazio di archiviazione specificato sono sempre le dimensioni di un puntatore, indipendentemente dal fatto che
del tipo da serializzare.

Se il valore è nil, nel contenuto XML viene scritto un elemento nil.
Se non è null, il valore viene serializzato normalmente.


WS_STRING valore; può contenere un valore nil (vedere WS_STRING_TYPE)
Api(..., &value, sizeof(value), ...);



se value è diverso da nil
hello

se value è nil



Questa opzione è supportata solo per i tipi seguenti, elencati di seguito.
che hanno un modo intrinseco per rappresentare un valore nil. Vedere la documentazione
per ogni tipo per informazioni su come viene rappresentato nil.
WS_WRITE_NILLABLE_POINTER
Valore: 4
Per tutti i tipi, l'archiviazione specificata contiene un puntatore al valore . Le
le dimensioni dello spazio di archiviazione specificato sono sempre le dimensioni di un puntatore, indipendentemente dal fatto che
del tipo da serializzare.

Se il puntatore al valore specificato nella risorsa di archiviazione è NULL,
Un elemento nil viene scritto nel contenuto XML.


int* valuePointer; può essere NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



se il valore è diverso da NULL
123

se il valore è NULL

Fabbisogno

Requisito Valore
client minimo supportato Windows 7 [app desktop | App UWP]
server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
intestazione webservices.h