Función WsWriteStartAttribute (webservices.h)

Esta operación comienza a escribir un atributo en el elemento actual. Se debe llamar a WsWriteStartElement para poder escribir un atributo. Una vez iniciado el atributo, el valor del atributo se puede escribir mediante WsWriteChars, WsWriteBytes o WsWriteValue. El atributo debe completarse mediante WsWriteEndAttribute.

Sintaxis

HRESULT WsWriteStartAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [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. El puntero debe hacer referencia a un objeto xml Writer válido.

[in, optional] prefix

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

[in] localName

Puntero WS_XML_STRING al nombre local usado por el atributo . Debe tener al menos un carácter largo.

[in] ns

Puntero WS_XML_STRING al espacio de nombres que se va a usar para el atributo .

Si no se especifica ningún prefijo, el escritor puede usar un prefijo en el ámbito enlazado al espacio de nombres especificado o puede generar un prefijo e incluir un atributo XMLNS.

Si se especifica un prefijo, el escritor usará ese prefijo y puede incluir un atributo XMLNS si es necesario para invalidar un prefijo existente en el ámbito.

[in] singleQuote

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

Nota Con WS_XML_WRITER_BINARY_ENCODING no se conserva el carácter de comillas 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

Si se especifica un prefijo NULL , el escritor elegirá un prefijo para el espacio de nombres.

Para escribir un atributo "xml:lang" o "xml:space", especifique "xml" para el prefijo, "lang" o "space" para localName y "http://www.w3.org/XML/1998/namespace" para el espacio de nombres.

Si escribir el atributo hace que WS_XML_WRITER_PROPERTY_MAX_ATTRIBUTES se supere, se devuelve WS_E_QUOTA_EXCEEDED .

Si se especifica un prefijo no vacío con un espacio de nombres vacío WS_E_INVALID_FORMAT se devuelve. (Consulte Valores devueltos de servicios web de Windows).

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