xlAutoRemove

Область применения: Excel 2013 | Office 2013 | Visual Studio

Вызывается Microsoft Excel всякий раз, когда пользователь отключает XLL во время сеанса Excel с помощью диспетчера Add-In. Вызов этой функции не выполняется, если сеанс Excel закрывается (правильно или ненормально) при установленной надстройке.

Эту функцию можно использовать для отображения пользовательского диалогового окна с сообщением пользователю о том, что надстройка отключена, или для чтения из реестра или записи в него, например.

Excel не требует XLL для реализации и экспорта этой функции.

int WINAPI xlAutoRemove(void);

Параметры

Эта функция не получает никаких аргументов.

Значение свойства или возвращаемое значение

Внедрении этой функции должно возвратить значение 1 (int).

Замечания

Используйте эту функцию, если XLL должен выполнить какую-либо задачу при ее удалении диспетчером Add-In.

Пример

См. файлы\SAMPLES\EXAMPLE\EXAMPLE.C и \SAMPLES\GENERIC\GENERIC.C примеры реализации этой функции. Следующий код получен из \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;
}

См. также

XlAutoДобавитьдиспетчер надстроек и функции интерфейса XLL