Compartilhar via

Função WsGetReaderNode (webservices.h)

  • Artigo

A função retorna o nó XML na posição atual do leitor XML.

Sintaxe

HRESULT WsGetReaderNode(
  [in]           WS_XML_READER     *xmlReader,
                 const WS_XML_NODE **node,
  [in, optional] WS_ERROR          *error
);

Parâmetros

[in] xmlReader

Um ponteiro para o leitor para o qual o nó atual será obtido. Isso deve ser válido WS_XML_READER objeto.

node

Uma referência a uma estrutura WS_XML_NODE em que o nó atual é retornado.

[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.

Comentários

O campo nodeType do nó do nó deve ser inspecionado para determinar o tipo de nó retornado. Em seguida, o nó pode ser convertido na estrutura de dados apropriada para obter os dados.

WS_XML_NODE* node;
if (SUCCEEDED(WsGetReaderNode(reader, &node, error)))
{
    if (node->nodeType == WS_XML_NODE_TYPE_ELEMENT)
    {
        WS_XML_ELEMENT_NODE* elementNode = (WS_XML_ELEMENT_NODE*) node;
        // Refer to elementNode->localName, elementNode->ns
    }
}

Os nodeTypes com estruturas estendidas incluem:

O nó retornado não deve ser modificado e só é válido até que o leitor avance. Para os atributos em um WS_XML_ELEMENT_NODE os chamadores não devem esperar que os atributos apareçam em nenhuma ordem específica.

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