SymbolInfoString

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

1. Imediatamente retorna o valor da 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.

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.