MarketBookRelease

Fecha o livro de ofertas (Depth of Market, DOM) para um ativo selecionado, e cancela a assinatura para receber notificações de alteração na DOM.

bool  MarketBookRelease(
   string  symbol      // ativo
   );

Parâmetros

symbol

[in] Nome do ativo.

Valor do Retorno

O valor true se a fechamento foi bem sucedido, caso contrário false.

Observação

Normalmente, esta função deve ser chamada da função OnDeinit(), se a correspondente função MarketBookAdd() foi chamada na função OnInit(). Ou ela deve ser chamada a partir do destrutor da classe, se a função MarketBookAdd() correspondente foi chamada a partir do construtor da classe.

Exemplo:

#define SYMBOL_NAME "GBPUSD"
 
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- abrimos o livro de ofertas do símbolo SYMBOL_NAME
   if(!MarketBookAdd(SYMBOL_NAME))
     {
      PrintFormat("MarketBookAdd(%s) failed. Error "SYMBOL_NAMEGetLastError());
      return;
     }
 
//--- mostramos no log a mensagem sobre a abertura bem-sucedida do livro de ofertas
   PrintFormat("The MarketBook for the '%s' symbol was successfully opened and a subscription to change it was received"SYMBOL_NAME);
   
//--- esperamos 2 segundos
   Sleep(2000);
   
//--- no final, cancelaremos a assinatura do livro de ofertas
//--- mostramos no log a mensagem sobre o cancelamento bem-sucedido da assinatura do livro de ofertas, ou imprimimos um erro
   ResetLastError();
   if(MarketBookRelease(SYMBOL_NAME))
      PrintFormat("MarketBook for the '%s' symbol was successfully closed"SYMBOL_NAME);
   else
      PrintFormat("Error %d occurred when closing MarketBook using the '%s' symbol"GetLastError(), SYMBOL_NAME);
      
   /*
   resultado:
   The MarketBook for the 'GBPUSDsymbol was successfully opened and a subscription to change it was received
   MarketBook for the 'GBPUSDsymbol was successfully closed
   */
  }

Também Veja

Estrutura da Profundidade de Mercado, Estruturas e Classes