WsWriteXmlnsAttribute, fonction (webservices.h)

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

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

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