Fonction WsReadQualifiedName (webservices.h)

  • Article

Lit un nom qualifié et le sépare en préfixe, localName et espace de noms en fonction de l’étendue d’espace de noms actuelle du XML_READER. Si le paramètre ns est spécifié, l’espace de noms auquel le préfixe est lié sera retourné ou WS_E_INVALID_FORMAT sera retourné. (Voir Valeurs de retour des services web Windows.) Les chaînes sont placées dans le tas spécifié.

Syntaxe

HRESULT WsReadQualifiedName(
  [in]           WS_XML_READER *reader,
  [in]           WS_HEAP       *heap,
                 WS_XML_STRING *prefix,
  [out]          WS_XML_STRING *localName,
                 WS_XML_STRING *ns,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] reader

Lecteur qui doit lire le nom qualifié.

[in] heap

Tas sur lequel les chaînes obtenues doivent être allouées.

prefix

Le préfixe du nom qualifié est retourné ici.

[out] localName

Le localName du nom qualifié est retourné ici.

ns

L’espace de noms auquel le nom qualifié est lié est retourné ici.

[in, optional] error

Si le localName est manquant, la fonction retourne WS_E_INVALID_FORMAT.
Si le paramètre ns est spécifié, mais que le préfixe n’est pas lié à un espace de noms, WS_E_INVALID_FORMAT sera retourné.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
WS_E_INVALID_FORMAT
 Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.

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