Compartilhar via

Função WsReadQualifiedName (webservices.h)

  • Artigo

Lê um nome qualificado e o separa em seu prefixo, localName e namespace com base no escopo do namespace atual do XML_READER. Se o parâmetro ns for especificado, o namespace ao qual o prefixo está associado será retornado ou WS_E_INVALID_FORMAT será retornado. (Consulte Valores retornados dos Serviços Web do Windows.) As cadeias de caracteres são colocadas no heap especificado.

Sintaxe

HRESULT WsReadQualifiedName(
  [in]           WS_XML_READER *reader,
  [in]           WS_HEAP       *heap,
                 WS_XML_STRING *prefix,
  [out]          WS_XML_STRING *localName,
                 WS_XML_STRING *ns,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] reader

O leitor que deve ler o nome qualificado.

[in] heap

O heap no qual as cadeias de caracteres resultantes devem ser alocadas.

prefix

O prefixo do nome qualificado é retornado aqui.

[out] localName

O localName do nome qualificado é retornado aqui.

ns

O namespace ao qual o nome qualificado está associado é retornado aqui.

[in, optional] error

Se o localName estiver ausente, a função retornará WS_E_INVALID_FORMAT.
Se o parâmetro ns for especificado, mas o prefixo não estiver associado a um namespace, WS_E_INVALID_FORMAT será retornado.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
WS_E_INVALID_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.

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