Compartilhar via


xlAutoRemove

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

Chamado pelo Microsoft Excel sempre que o usuário desativa a XLL durante uma sessão do Excel usando o gerenciador de Add-In. Esta função não é chamada quando uma sessão do Excel é fechada, normalmente ou de forma anormal, com o suplemento instalado.

Essa função pode ser usada para exibir uma caixa de diálogo personalizada informando ao usuário que o suplemento foi desativado ou para ler ou gravar no registro, por exemplo.

O Excel não requer uma XLL para implementar e exportar essa função.

int WINAPI xlAutoRemove(void);

Parâmetros

Essa função não usa argumentos.

Valor de propriedade/Valor de retorno

A implementação dessa função deve retornar 1 (int).

Comentários

Use essa função se a XLL precisar concluir qualquer tarefa quando ela for removida pelo gerenciador de Add-In.

Exemplo

Consulte os arquivos\SAMPLES\EXAMPLE\EXAMPLE.C e \SAMPLES\GENERIC\GENERIC.C , por exemplo, implementações dessa função. O código a seguir é de \SAMPLES\EXAMPLE\EXAMPLE.C.

int WINAPI xlAutoRemove(void)
{
/* Display a dialog box indicating that the XLL was successfully removed */
   Excel12f(xlcAlert, 0, 2,
      TempStr12(L"Thank you for removing Example.XLL!"),
      TempInt12(2));
   return 1;
}

Confira também

XlAutoAddAdd-in Manager e Funções de Interface XLL