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 |
---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
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). |
|
Memoria insuficiente para completar la operación. |
|
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 |