Compartilhar via

Função WsWriteQualifiedName (webservices.h)

  • Artigo

Grava um nome qualificado XML no Gravador.

Sintaxe

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] 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 nome qualificado é gravado. O ponteiro deve referenciar um objeto gravador XML válido.

[in, optional] prefix

Um ponteiro WS_XML_STRING para o prefixo usado pelo nome qualificado. Se o valor referenciado por esse parâmetro for NULL , o Gravador escolherá um prefixo.

[in] localName

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

[in, optional] ns

Um ponteiro WS_XML_STRING para o namespace usado para o nome qualificado.

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.

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_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.

Comentários

  • Se o prefixo for NULL, o namespace não deverá ser NULL. Nesse caso, o gravador tentará encontrar um prefixo no escopo associado ao namespace especificado. Se um prefixo apropriado for encontrado, ele será usado. Caso contrário, o Gravador gerará um prefixo e inserirá um atributo XMLNS no elemento atual. Se o gravador não estiver em um elemento , a função retornará WS_E_INVALID_FORMAT.

    (Consulte Valores retornados dos Serviços Web do Windows.)

  • Se o prefixo não for NULL e o namespace não for NULL , o Gravador verificará se o prefixo está atualmente associado ao namespace especificado e retornará WS_E_INVALID_FORMAT caso contrário.
  • Se o prefixo não for NULL e o namespace for NULL , o Gravador usará o prefixo e o nome local para gravar o nome qualificado.

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