Compartir a través de

Función WsWriteXmlnsAttribute (webservices.h)

  • Artículo

Escribe un atributo Xmlns en el elemento actual. Se debe llamar a WsWriteStartElement antes de que se pueda escribir un atributo y si el número de atributos supera el número máximo de atributos permitidos para el escritor, la función devuelve WS_E_QUOTA_EXCEEDED. (Vea Valores devueltos de servicios web de Windows).

Sintaxis

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Parámetros

[in] writer

Puntero al objeto WS_XML_WRITER en el que se escribe el atributo Xmlns. El puntero debe hacer referencia a un objeto de escritura XML válido.

[in, optional] prefix

Puntero WS_XML_STRING al prefijo que se va a usar para el elemento start. Si el valor al que hace referencia este parámetro es NULL , el escritor elegirá un atributo.

Especifica el prefijo que se va a usar para el atributo xmlns.

[in] ns

Puntero WS_XML_STRING al espacio de nombres que se va a enlazar al prefijo.

[in] singleQuote

Determina si se debe usar una comilla simple o doble para el valor del atributo.

Nota Si WS_XML_WRITER_BINARY_ENCODING se establece el carácter de comillas no se conserva y este parámetro no tiene ningún efecto.

 

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Uno o más argumentos no son válidos.
WS_E_INVALID_OPERATION
 No se permite la operación debido al estado actual del objeto .
WS_E_INVALID_FORMAT
 Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
WS_E_QUOTA_EXCEEDED
 Se superó una cuota.

Comentarios

Se aplican las siguientes condiciones:

  • Si se especifica un prefijo vacío, se asigna el espacio de nombres predeterminado.
  • Si se especifica un prefijo NULL , el escritor elige el prefijo adecuado para el espacio de nombres.
  • Si el atributo Xmlns es redundante, no se puede escribir.
  • Si se especifica un prefijo no vacío con un espacio de nombres vacío WS_E_INVALID_FORMAT se devuelve.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll