Freigeben über


xlfUnregister (Formular 2)

Gilt für: Excel 2013 | Office 2013 | Visual Studio

Kann von einer DLL oder einem XLL-Befehl aufgerufen werden, der selbst von Microsoft Excel aufgerufen wurde. Dies entspricht dem Aufrufen von UNREGISTER aus einem Excel XLM-Makroblatt.

xlfUnregister kann in zwei Formen aufgerufen werden:

  • Formular 1: Hebt die Registrierung eines einzelnen Befehls oder einer Funktion auf.

  • Formular 2: Entlädt und deaktiviert eine XLL.

Diese Funktion wird in Form 2 aufgerufen und erzwingt, dass eine DLL oder Coderessource vollständig entladen wird. Es hebt die Registrierung aller Funktionen in einer DLL auf, auch wenn sie derzeit von einem anderen Makro verwendet werden, unabhängig von der Nutzungsanzahl. Diese Funktion ruft xlAutoClose auf und hebt dann die Registrierung aller Funktionen in der DLL auf.

Excel12(xlfUnregister, LPXLOPER12 pxRes, 1, LPXLOPER12 pxModuleText);

Parameter

pxModuleText (xltypeStr)

Der Name der DLL.

Eigenschaftswert/Rückgabewert

Bei erfolgreicher Ausführung wird TRUE (xltypeBool) zurückgegeben. Wenn der Fehler nicht erfolgreich ist, wird FALSE zurückgegeben.

Hinweise

Hinweis

Rufen Sie diese Form der Funktion nicht aus Ihrer Implementierung von xlAutoClose auf, um die Registrierung aller DLL-Ressourcen mit einem einfachen Funktionsaufruf aufzuheben. Dies führt zu einem rekursiven Aufruf von xlAutoClose und einem Stapelüberlauf.

Vergessen Sie nicht, Namen zu löschen.

Wenn Sie das pxFunctionText-Argument für xlfRegister angegeben haben, müssen Sie beim Registrieren der Funktionen und Befehle der DLL die Namen explizit löschen, indem Sie für jeden xlfSetName aufrufen und dabei das zweite Argument weglassen, damit die Funktion nicht mehr im Funktions-Assistenten angezeigt wird. Weitere Informationen finden Sie unter Bekannte Probleme bei der Excel-XLL-Entwicklung.

Siehe auch