Informações de Mercado : SymbolInfoString

Retorna a propriedade correspondente de um ativo especificado. Existem 2 variantes da função.

1. Imediatamente retorna o valor da propriedade.

string  SymbolInfoString(
string                   name,        // Ativo
ENUM_SYMBOL_INFO_STRING  prop_id      // Identificador de propriedade
);

2. Retorna true ou false, dependendo do sucesso na execução da função. Se for bem sucedido, o valor da propriedade é colocada em uma variável de recbimento passada por referência no último parâmetro.

bool  SymbolInfoString(
string                   name,        // Ativo
ENUM_SYMBOL_INFO_STRING  prop_id,     // Identificador de propriedade
string&                  string_var   // Aqui nós assumimos o valor da propriedade
);

Parâmetros

name

[in] Nome do ativo.

prop_id

[in] Identificador de um propriedade de ativo. O valor pode ser um dos valores da enumeração ENUM_SYMBOL_INFO_STRING.

string_var

[out] Variável de tipo string recebendo o valor da propriedade solicitada.

Valor do Retorno

Valor de tipo string. Em caso de falha de execução, a informação sobre o erro pode ser obtida usando a função GetLastError():

•5040 – parâmetro de string inválido para especificar um nome de ativo,
•4301 – ativo desconhecido (instrumento financeiro),
•4302 – ativo não está selecionado no “Observador de Mercado” (não encontrado na lista de ativos disponíveis),
•4303 – identificador inválido de uma propriedade de ativo.
Observação

É recomendável usar SymbolInfoTick() se a função for usada para obter informações sobre o último tick. É bom possível que nenhuma cotação tenha aparecido ainda desde que o terminal se conectou a uma conta de negociação. Em tal situação, o valor solicitado será indefinido

Na maioria dos casos, é suficiente usar a função SymbolInfoTick() permitindo a um usuário receber os valores dos preços Compra, Venda, Último, Volume e a hora da chegada do último tick através de uma única chamada.