Partager via

énumération WS_WRITE_OPTION (webservices.h)

  • Article

Spécifie si un stockage spécifié contient la valeur, ou un pointeur vers la valeur, et si la valeur peut être représentée comme nulle dans le contenu XML.

Syntaxe

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
Valeur : 1
Le stockage spécifié contient la valeur. Taille du stockage
spécifié doit être la taille de la valeur.

Cette option spécifie que la valeur sera toujours écrite dans le contenu XML.


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



toujours écrit
123


Cette option n’est pas prise en charge pour les types de pointeur
(WS_WSZ_TYPE et WS_XML_BUFFER_TYPE).
L’option WS_WRITE_REQUIRED_POINTER doit être utilisée pour ces types.
WS_WRITE_REQUIRED_POINTER
Valeur : 2
Le stockage spécifié contient un pointeur vers la valeur. Le
la taille du stockage spécifié est toujours la taille d’un pointeur, quelle que soit la taille
du type sérialisé.

Cette option spécifie que la valeur sera toujours écrite dans le contenu XML.


int* valuePointer ; peut ne pas être NULL
Api(..., &valuePointer, sizeof(valuePointer), ...) ;



toujours écrit
123


Si le pointeur vers la valeur spécifiée dans le stockage est NULL ,
E_INVALIDARG est retourné.
(Consultez valeurs de retour des services web Windows.)
WS_WRITE_NILLABLE_VALUE
Valeur : 3
Le stockage spécifié contient un pointeur vers la valeur. Le
la taille du stockage spécifié est toujours la taille d’un pointeur, quelle que soit la taille
du type sérialisé.

Si la valeur est nulle, un élément nil est écrit dans le contenu XML.
Si elle n’est pas nulle, la valeur est sérialisée normalement.


valeur WS_STRING ; peut contenir une valeur nulle (voir WS_STRING_TYPE)
Api(..., &valeur, sizeof(value), ...) ;



si la valeur n’est pas nulle
bonjour

si la valeur est nulle



Cette option est uniquement prise en charge pour les types suivants, répertoriés ci-dessous,
qui ont un moyen intrinsèque de représenter une valeur nulle. Consultez la documentation
pour chaque type pour obtenir des informations sur la façon dont nil est représenté.
WS_WRITE_NILLABLE_POINTER
Valeur : 4
Pour tous les types, le stockage spécifié contient un pointeur vers la valeur. Le
la taille du stockage spécifié est toujours la taille d’un pointeur, quelle que soit la taille
du type sérialisé.

Si le pointeur vers la valeur spécifiée dans le stockage est NULL, puis
un élément nil est écrit dans le contenu XML.


int* valuePointer ; peut être NULL
Api(..., &valuePointer, sizeof(valuePointer), ...) ;



si la valeur n’est pas NULL
123

si la valeur est NULL

Exigences

Exigence Valeur
client minimum pris en charge Windows 7 [applications de bureau | Applications UWP]
serveur minimum pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
d’en-tête webservices.h