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.

[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.

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