WsWriteAttribute, fonction (webservices.h)

Écrivez une valeur typée en tant qu’attribut XML.

Syntaxe

HRESULT WsWriteAttribute(
  [in]           WS_XML_WRITER                  *writer,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_WRITE_OPTION                writeOption,
                 const void                     *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

Paramètres

[in] writer

Writer dans lequel écrire l’attribut.

[in] attributeDescription

Pointeur vers une description de la sérialisation de l’attribut.

[in] writeOption

Informations sur la façon dont la valeur est allouée. Pour plus d’informations, consultez WS_WRITE_OPTION .

value

Pointeur vers la valeur à sérialiser.

[in] valueSize

Taille de la valeur sérialisée, en octets.

Si la valeur est NULL, la taille doit être 0.

[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.

Remarques

Cette API écrit l’attribut de début, la valeur de l’attribut et l’attribut de fin.

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