Compartilhar via


Função WsWriteEndStartElement (webservices.h)

Força o gravador a confirmar o elemento atual e impedir que outros atributos sejam gravados no elemento .

Sintaxe

HRESULT WsWriteEndStartElement(
  [in]           WS_XML_WRITER *writer,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] writer

O gravador para o qual o elemento atual deve ser confirmado.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Valor retornado

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

Ocasionalmente, é útil forçar explicitamente a conclusão de um elemento. Isso pode ser usado para forçar o gravador a escrever um elemento completo e um par. Também pode ser útil ao obter posições ao gravar em um WS_XML_BUFFER.

Chamar essa API quando não houver nenhum elemento para confirmar fará com que ela retorne WS_E_INVALID_OPERATION. (Consulte Valores retornados dos Serviços Web do Windows.)

Requisitos

   
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