Méthode IWSDXMLContext ::AddNamespace (wsdxml.h)

Article
03/04/2024

Crée un objet qui représente un espace de noms dans un contexte XML. Si l’espace de noms existe déjà, aucun nouvel espace de noms n’est ajouté et l’objet d’espace de noms correspondant au nom existant est retourné.

Syntaxe

HRESULT AddNamespace(
  [in]  LPCWSTR          pszUri,
  [in]  LPCWSTR          pszSuggestedPrefix,
  [out] WSDXML_NAMESPACE **ppNamespace
);

Paramètres

[in] pszUri

URI de l’espace de noms.

[in] pszSuggestedPrefix

Préfixe d’espace de noms à utiliser lors de la génération du code XML. Si l’espace de noms existe déjà, pszSuggestedPrefix remplacera le préfixe actuellement associé à l’espace de noms. Le contexte XML peut affecter un préfixe d’espace de noms différent. Le préfixe attribué par le contexte XML est prioritaire sur le préfixe suggéré. Le membre PreferredPrefix de la structure pointée vers par ppNamespace contient le préfixe attribué par le contexte XML.

[out] ppNamespace

Pointeur vers l’adresse de la structure WSDXML_NAMESPACE qui représente l’espace de noms. Vous devez libérer ppNamespace en appelant WSDFreeLinkedMemory. Ce paramètre est facultatif.

Valeur renvoyée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	pszUri a la valeur NULL, la longueur en caractères de la chaîne d’URI dépasse WSD_MAX_TEXT_LENGTH (8192), pszSuggestedPrefix a la valeur NULL ou la longueur en caractères de la chaîne de préfixe dépasse WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
E_FAIL	Échec de la méthode.

Remarques

La structure WSDXML_NAMESPACE retournée peut être utilisée pour forcer une association entre le préfixe d’espace de noms (tel que spécifié par pszSuggestedPrefix) et l’URI d’espace de noms (tel que spécifié par pszUri). Une fois cette association établie, le générateur XML produit du code XML avec le préfixe d’espace de noms spécifié.

Vous pouvez appeler AddNamespace pour récupérer la structure WSDXML_NAMESPACE créée lorsqu’un espace de noms a été généré automatiquement par un appel à AddNameToNamespace.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsdxml.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDXMLContext

Partager via