WsGetNamespaceFromPrefix, fonction (webservices.h)

Article
08/27/2023

Cette fonction retourne un espace de noms à partir du préfixe auquel il est lié.

Si la valeur du paramètre requis est définie sur TRUE et que le préfixe n’est lié à aucun espace de noms , une exception de WS_E_INVALID_FORMAT est retournée. (Voir Valeurs de retour des services Web Windows.) Si le paramètre requis est FALSE et que le préfixe n’est lié à aucun espace de noms, le paramètre ns est NULL et la fonction retourne S_FALSE.

Syntaxe

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] reader

Pointeur vers le lecteur pour lequel le préfixe doit faire l’objet d’une recherche.

[in] prefix

Pointeur vers le préfixe à rechercher.

[in] required

La valeur de ce paramètre booléen détermine si une erreur doit être retournée si un espace de noms correspondant est introuvable.

ns

Référence à un espace de noms auquel le préfixe est lié en cas de réussite. La valeur retournée n’est valide que jusqu’à ce que l’enregistreur avance.

[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
WS_E_INVALID_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.

Remarques

Pour le préfixe « xml », il retourne l’espace de noms «http://www.w3.org/XML/1998/namespace" ; ».

Pour le préfixe « xmlns », l’espace de noms «http://www.w3.org/2000/xmlns/" ; » est retourné.

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