Función WsWriteXmlnsAttribute (webservices.h)

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