WsWriteQualifiedName, fonction (webservices.h)

Écrit un nom qualifié XML dans l’enregistreur.

Syntaxe

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] writer

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

[in, optional] prefix

Pointeur WS_XML_STRING vers le préfixe utilisé par le nom qualifié. Si la valeur référencée par ce paramètre est NULL , l’enregistreur choisit un préfixe.

[in] localName

Pointeur WS_XML_STRING vers le nom local utilisé par le nom qualifié. Il doit comporter au moins un caractère.

[in, optional] ns

Pointeur WS_XML_STRING vers l’espace de noms utilisé pour le nom qualifié.

Si aucun préfixe n’est spécifié, l’enregistreur peut utiliser un préfixe dans l’étendue lié à l’espace de noms spécifié ou il peut générer un préfixe et inclure un attribut XMLNS.

Si un préfixe est spécifié, l’enregistreur utilise ce préfixe et peut inclure un attribut XMLNS si nécessaire pour remplacer un préfixe existant dans l’étendue.

[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

• Si le préfixe est NULL, l’espace de noms ne doit pas être NULL. Dans ce cas, l’enregistreur essaiera de trouver un préfixe dans l’étendue lié à l’espace de noms spécifié. Si un préfixe approprié est trouvé, il sera utilisé. Si ce n’est pas le cas, l’enregistreur génère un préfixe et insère un attribut XMLNS sur l’élément actuel. Si l’enregistreur ne se trouve pas dans un élément, la fonction retourne WS_E_INVALID_FORMAT.

  (Voir Valeurs de retour des services Web Windows.)

• Si le préfixe n’est pas NULL et que l’espace de noms n’est pas NULL, writer vérifie que le préfixe est actuellement lié à l’espace de noms spécifié et retourne WS_E_INVALID_FORMAT dans le cas contraire.
• Si le préfixe n’est pas NULL et que l’espace de noms a la valeur NULL , writer utilise le préfixe et le nom local pour écrire le nom qualifié.

Configuration requise