Função WsWriteStartAttribute (webservices.h)

Essa operação começa a gravar um atributo no elemento atual. WsWriteStartElement deve ser chamado antes que um atributo possa ser gravado. Depois que o atributo for iniciado, o valor do atributo poderá ser gravado usando WsWriteChars, WsWriteBytes ou WsWriteValue. O atributo deve ser concluído usando WsWriteEndAttribute.

Sintaxe

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

Um ponteiro para o objeto WS_XML_WRITER no qual o atributo é 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 atributo. 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 atributo . Deve ter pelo menos um caractere de comprimento.

[in] ns

Um WS_XML_STRING ponteiro para o namespace a ser usado para o atributo.

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] singleQuote

Determina se uma aspa única ou dupla deve ser usada para o valor do atributo.

Nota Com WS_XML_WRITER_BINARY_ENCODING o caractere de aspas não é preservado e esse parâmetro não tem efeito.

 

[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 um prefixo NULL for especificado, o gravador escolherá um prefixo para o namespace.

Para escrever um atributo "xml:lang" ou "xml:space", especifique "xml" para o prefixo, "lang" ou "space" para o localName e "http://www.w3.org/XML/1998/namespace" para o namespace.

Se a gravação do atributo fizer com que WS_XML_WRITER_PROPERTY_MAX_ATTRIBUTES seja excedido , WS_E_QUOTA_EXCEEDED será retornado.

Se um prefixo não vazio for especificado com um namespace vazio WS_E_INVALID_FORMAT será retornado. (Consulte Valores retornados dos Serviços Web do Windows.)

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