Função WsWriteStartElement (webservices.h)

Grava um elemento start no gravador.

Depois de chamar essa função , WsWriteStartAttribute ou WsWriteXmlnsAttribute pode ser chamado para gravar atributos adicionais no elemento. O elemento não é confirmado para o gravador até que WsWriteEndElement ou alguma outra função que grava conteúdo seja chamada.

Sintaxe

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

Um ponteiro para o objeto WS_XML_WRITER no qual o elemento inicial é gravado. O ponteiro deve referenciar um objeto gravador XML válido.

[in, optional] prefix

Um ponteiro WS_XML_STRING para o prefixo a ser usado para o elemento start. Se o valor referenciado por esse parâmetro for NULL , o Gravador escolherá um atributo.

[in] localName

Um ponteiro WS_XML_STRING para o nome local usado pelo elemento start. Deve ter pelo menos um caractere de comprimento.

[in] ns

Um WS_XML_STRING ponteiro para o namespace a ser usado para o elemento start.

Se nenhum prefixo for especificado, o Gravador poderá usar um prefixo no escopo associado ao namespace especificado ou pode gerar um prefixo e incluir um atributo XMLNS. Se um prefixo for especificado, o Gravador usará esse prefixo e poderá incluir um atributo XMLNS, se necessário, para substituir um prefixo existente no escopo.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno	Descrição
E_INVALIDARG	Um ou mais argumentos são inválidos.
WS_E_INVALID_OPERATION	A operação não é permitida devido ao estado atual do objeto.
WS_E_INVALID_FORMAT	Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
WS_E_QUOTA_EXCEEDED	Uma cota foi excedida.

Comentários

Se a codificação subjacente der suporte a elementos vazios e o elemento não tiver conteúdo, um elemento vazio será gravado.

Se um prefixo não vazio for especificado com um namespace vazio WS_E_INVALID_FORMAT será retornado.

Se a gravação do elemento start fizer com que WS_XML_WRITER_PROPERTY_MAX_DEPTH seja excedido WS_E_QUOTA_EXCEEDED será retornado. (Consulte Valores retornados dos Serviços Web do Windows.)

Ao usar WS_XML_WRITER_MTOM_ENCODING é um erro tentar gravar um elemento com o localName "Include" do namespace"http://www.w3.org/2004/08/xop/include".

WsWriteStartAttribute também pode ser usado para adicionar um atributo a um elemento quando o gravador é posicionado em um elemento usando WsMoveWriter ou WsSetWriterPosition.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	webservices.h
Biblioteca	WebServices.lib
DLL	WebServices.dll