Compartilhar via

Função WsWriteXmlnsAttribute (webservices.h)

  • Artigo

Grava um atributo Xmlns no elemento atual. WsWriteStartElement deve ser chamado antes que um atributo possa ser gravado e se o número de atributos exceder o número máximo de atributos permitidos para o gravador, a função retornará WS_E_QUOTA_EXCEEDED. (Consulte Valores retornados dos Serviços Web do Windows.)

Sintaxe

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [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 ao qual o atributo Xmlns é 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.

Especifica o prefixo a ser usado para o atributo xmlns.

[in] ns

Um ponteiro WS_XML_STRING para o namespace a ser associado ao prefixo.

[in] singleQuote

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

Nota Se WS_XML_WRITER_BINARY_ENCODING for definido, o caractere de aspas não será preservado e esse parâmetro não terá 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

As seguintes condições se aplicam:

  • Se um prefixo vazio for especificado, o namespace padrão será atribuído.
  • Se um prefixo NULL for especificado, o Gravador escolherá o prefixo apropriado para o namespace.
  • Se o atributo Xmlns for redundante, ele não poderá ser gravado.
  • Se um prefixo não vazio for especificado com um namespace vazio WS_E_INVALID_FORMAT será retornado.

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