WsWriteEndStartElement, fonction (webservices.h)

Article
08/27/2023

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

Partager via