WsWriteXmlnsAttribute, fonction (webservices.h)

Article
03/09/2024

Écrit un attribut Xmlns dans l’élément actuel. WsWriteStartElement doit être appelé avant qu’un attribut puisse être écrit et si le nombre d’attributs dépasse le nombre maximal d’attributs autorisé pour l’enregistreur, la fonction retourne WS_E_QUOTA_EXCEEDED. (Voir Valeurs de retour des services web Windows.)

Syntaxe

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] writer

Pointeur vers l’objet WS_XML_WRITER dans lequel l’attribut Xmlns est écrit. Le pointeur doit référencer un objet Writer XML valide.

[in, optional] prefix

Un pointeur WS_XML_STRING vers le préfixe à utiliser pour l’élément start. Si la valeur référencée par ce paramètre est NULL , l’enregistreur choisit un attribut.

Spécifie le préfixe à utiliser pour l’attribut xmlns.

[in] ns

Un pointeur WS_XML_STRING vers l’espace de noms à lier au préfixe.

[in] singleQuote

Détermine s’il faut utiliser un guillemet simple ou double pour la valeur d’attribut.

Note Si WS_XML_WRITER_BINARY_ENCODING est défini, le caractère de guillemet n’est pas conservé et ce paramètre n’a aucun effet.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur 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

Les conditions suivantes s’appliquent :

Si un préfixe vide est spécifié, l’espace de noms par défaut est affecté.
Si un préfixe NULL est spécifié, l’enregistreur choisit le préfixe approprié pour l’espace de noms.
Si l’attribut Xmlns est redondant, il ne peut pas être écrit.
Si un préfixe non vide est spécifié avec un espace de noms vide WS_E_INVALID_FORMAT est retourné.

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