WsGetNamespaceFromPrefix, fonction (webservices.h)

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.

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