WsWriteType, fonction (webservices.h)

Article
03/06/2024

Écrivez une valeur d’un WS_TYPE donné dans XML en fonction de la WS_TYPE_MAPPING.

Syntaxe

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Paramètres

[in] writer

Writer dans lequel écrire la valeur.

[in] typeMapping

Décrit la façon dont le type est mappé au xml en cours d’écriture.

[in] type

Type de la valeur à sérialiser.

[in, optional] typeDescription

Informations supplémentaires sur le type. Chaque type a une structure de description différente. Cela peut être NULL, selon le WS_TYPE.

[in] writeOption

Indique si la valeur est requise et comment la valeur est allouée. Pour plus d’informations, consultez WS_WRITE_OPTION .

Ce paramètre doit avoir l’une des valeurs suivantes :

value

Pointeur vers la valeur à sérialiser.

[in] valueSize

Taille de la valeur sérialisée.

[in, optional] error

Spécifie l’emplacement où des informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
WS_E_INVALID_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

Remarques

Consultez WS_TYPE_MAPPING pour savoir comment utiliser cette fonction pour écrire des valeurs dans des éléments et des attributs.

Si l’API échoue, l’état de l’enregistreur d’entrée devient indéfini. Les seules API qui peuvent être utilisées sur l’enregistreur si cela se produit sont WsSetOutput et WsSetOutputToBuffer pour renvoyer l’enregistreur à un état utilisable, ou WsFreeWriter pour libérer l’enregistreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Partager via