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