xlAutoRemove
Gilt für: Excel 2013 | Office 2013 | Visual Studio
Wird von Microsoft Excel aufgerufen, wenn der Benutzer die XLL während einer Excel-Sitzung mithilfe des Add-In-Managers deaktiviert. Diese Funktion wird nicht aufgerufen, wenn eine Excel-Sitzung mit dem installierten Add-In (ordnungsgemäß oder unerwartet) beendet wird.
Diese Funktion kann verwendet werden, um ein benutzerdefiniertes Dialogfeld anzuzeigen, das dem Benutzer mitteilt, dass das Add-In deaktiviert wurde, oder um z. B. aus der Registrierung zu lesen oder in die Registrierung zu schreiben.
Excel erfordert keine XLL, um diese Funktion zu implementieren und zu exportieren.
int WINAPI xlAutoRemove(void);
Parameter
Diese Funktion verwendet keine Parameter.
Eigenschaftswert/Rückgabewert
Die Implementierung dieser Funktion muss 1 zurückgeben (Int).
Hinweise
Verwenden Sie diese Funktion, wenn Ihre XLL eine Aufgabe ausführen muss, wenn sie vom Add-In-Manager entfernt wird.
Beispiel
Sehen Sie sich die Dateien\SAMPLES\EXAMPLE\EXAMPLE.C und \SAMPLES\GENERIC\GENERIC.C Beispielimplementierungen dieser Funktion an. Der folgende Code stammt aus \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;
}