Compartir a través de


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

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

Sintaxis

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

Parámetros

[in] pszUri

URI del espacio de nombres.

[in] pszSuggestedPrefix

Prefijo de espacio de nombres que se va a usar al generar XML. Si el espacio de nombres ya existe, pszSuggestedPrefix sobrescribirá el prefijo asociado actualmente al espacio de nombres. El contexto XML puede asignar un prefijo de espacio de nombres diferente. El prefijo asignado por el contexto XML tiene prioridad sobre el prefijo sugerido. El miembro PreferredPrefix de la estructura a la que apunta ppNamespace contiene el prefijo asignado por el contexto XML.

[out] ppNamespace

Puntero a la dirección de la estructura WSDXML_NAMESPACE que representa el espacio de nombres. Debe desasignar ppNamespace 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, la longitud en caracteres de la cadena de URI supera WSD_MAX_TEXT_LENGTH (8192), pszSuggestedPrefix es NULL o la longitud en caracteres de la cadena de prefijo supera WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
Memoria insuficiente para completar la operación.
E_FAIL
Error en el método.

Comentarios

La estructura de WSDXML_NAMESPACE devuelta se puede usar para forzar una asociación entre el prefijo del espacio de nombres (como se especifica en pszSuggestedPrefix) y el URI del espacio de nombres (tal y como especifica pszUri). Una vez establecida esta asociación, el generador XML generará XML con el prefijo de espacio de nombres especificado.

Puede llamar a AddNamespace para recuperar la estructura de WSDXML_NAMESPACE creada cuando un espacio de nombres se generó automáticamente mediante una llamada a AddNameToNamespace.

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