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

  • Artículo

Crea un objeto que representa un nombre en un espacio de nombres en un contexto XML. Si el nombre ya existe en el espacio de nombres, no se agregará ningún nombre nuevo y se devolverá el objeto name del nombre existente.

Sintaxis

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

Parámetros

[in] pszUri

URI del espacio de nombres XML en el que se creará este nombre. Si este espacio de nombres aún no existe en el contexto XML, se generará automáticamente una nueva estructura de espacio de nombres.

[in] pszName

Nombre que se va a agregar al espacio de nombres especificado por pszUri.

[out] ppName

Estructura WSDXML_NAME para el nombre recién creado. Debe desasignar ppName llamando a WSDFreeLinkedMemory. Este parámetro es opcional.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
 pszUri es NULL o la longitud en caracteres de la cadena de URI supera WSD_MAX_TEXT_LENGTH (8192). pszName es NULL o la longitud en caracteres de la cadena de nombre supera WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.
E_FAIL
 Error en el método.

Comentarios

AddNameToNamespace se puede usar al crear elementos XML para secciones extensibles. Las secciones extensibles se representan mediante cualquier elemento de un esquema. La estructura de WSDXML_NAME devuelta a la que apunta ppName se puede usar para especificar el nombre asociado al contenido de la extensión. Al compilar una estructura de WSDXML_ELEMENT que representa el contenido de la extensión, use la estructura de WSDXML_NAME devuelta para el miembro Name del elemento.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdxml.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDXMLContext