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

Article
03/13/2024

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

Syntaxe

HRESULT AddNameToNamespace(
  [in]  LPCWSTR     pszUri,
  [in]  LPCWSTR     pszName,
  [out] WSDXML_NAME **ppName
);

Paramètres

[in] pszUri

URI de l’espace de noms XML dans lequel ce nom sera créé. Si cet espace de noms n’existe pas déjà dans le contexte XML, une nouvelle structure d’espace de noms est générée automatiquement.

[in] pszName

Nom à ajouter à l’espace de noms spécifié par pszUri.

[out] ppName

Structure WSDXML_NAME pour le nom nouvellement créé. Vous devez libérer ppName 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 ou la longueur en caractères de la chaîne d’URI dépasse WSD_MAX_TEXT_LENGTH (8192). pszName a la valeur NULL ou la longueur en caractères de la chaîne de nom 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

AddNameToNamespace peut être utilisé lors de la création d’éléments XML pour des sections extensibles. Les sections extensibles sont représentées par l’élément any dans un schéma. La structure WSDXML_NAME retournée pointée par ppName peut être utilisée pour spécifier le nom associé au contenu de l’extension. Lors de la création d’une structure WSDXML_ELEMENT qui représente le contenu de l’extension, utilisez la structure WSDXML_NAME retournée pour le membre Name de l’élément.

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