Función WsWriteStartElement (webservices.h)

Escribe un elemento de inicio en el escritor.

Después de llamar a esta función WsWriteStartAttribute o WsWriteXmlnsAttribute se puede llamar a para escribir atributos adicionales en el elemento. El elemento no se confirma en el escritor hasta que se llama a WsWriteEndElement u otra función que escribe contenido.

Sintaxis

HRESULT WsWriteStartElement(
  [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, optional] WS_ERROR            *error
);

Parámetros

[in] writer

Puntero al objeto WS_XML_WRITER en el que se escribe el elemento start. 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 elemento start. 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 elemento start. 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 elemento start.

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, 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 la codificación subyacente admite elementos vacíos y el elemento no tiene contenido, se escribe un elemento vacío.

Si se especifica un prefijo no vacío con un espacio de nombres vacío WS_E_INVALID_FORMAT se devuelve.

Si escribir el elemento start hace que WS_XML_WRITER_PROPERTY_MAX_DEPTH se supere WS_E_QUOTA_EXCEEDED se devuelve. (Consulte Valores devueltos de servicios web de Windows).

Cuando se usa WS_XML_WRITER_MTOM_ENCODING se produce un error al intentar escribir un elemento con el valor localName "Include" del espacio de nombres"http://www.w3.org/2004/08/xop/include".

WsWriteStartAttribute también se puede usar para agregar un atributo a un elemento cuando el escritor se coloca en un elemento mediante WsMoveWriter o WsSetWriterPosition.

Requisitos