Partager via

WsWriteEndStartElement, fonction (webservices.h)

  • Article

Force l’enregistreur à valider l’élément actuel et empêche l’écriture d’autres attributs dans l’élément.

Syntaxe

HRESULT WsWriteEndStartElement(
  [in]           WS_XML_WRITER *writer,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] writer

Enregistreur pour lequel l’élément actuel doit être engagé.

[in, optional] error

Spécifie l’emplacement où les 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
E_INVALIDARG
 Un ou plusieurs arguments ne sont pas valides.
WS_E_INVALID_OPERATION
 L’opération n’est pas autorisée en raison de l’état actuel de l’objet.
WS_E_INVALID_FORMAT
 Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
WS_E_QUOTA_EXCEEDED
 Un quota a été dépassé.

Remarques

Parfois, il est utile de forcer explicitement l’achèvement d’un élément. Cela peut être utilisé pour forcer l’enregistreur à écrire un élément et une paire complets. Il peut également être utile lors de l’obtention de positions lors de l’écriture dans un WS_XML_BUFFER.

L’appel de cette API lorsqu’il n’y a aucun élément à valider entraîne son retour WS_E_INVALID_OPERATION. (Voir Valeurs de retour des services web Windows.)

Configuration requise

   
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