Partager via


xlfUnregister (formulaire 2)

S’applique à: Excel 2013 | Office 2013 | Visual Studio

Peut être appelé à partir d’une commande DLL ou XLL qui a elle-même été appelée par Microsoft Excel. Cela revient à appeler UNREGISTER à partir d’une feuille macro Excel XLM.

xlfUnregister peut être appelé sous deux formes :

  • Formulaire 1 : annule l’inscription d’une commande ou d’une fonction individuelle.

  • Formulaire 2 : décharge et désactive un XLL.

Appelée au formulaire 2, cette fonction force le déchargement complet d’une DLL ou d’une ressource de code. Il annule l’inscription de toutes les fonctions dans une DLL, même si elles sont actuellement utilisées par une autre macro, quel que soit le nombre d’utilisations. Cette fonction appelle xlAutoClose, puis annule l’inscription de toutes les fonctions dans la DLL.

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

Paramètres

pxModuleText (xltypeStr)

Nom de la DLL.

Valeur de propriété/valeur de renvoi

En cas de réussite, retourne TRUE (xltypeBool). En cas d’échec, retourne FALSE.

Remarques

Remarque

N’appelez pas cette forme de la fonction à partir de votre implémentation de xlAutoClose dans une tentative d’annulation de l’inscription de toutes les ressources de la DLL avec un appel de fonction simple. Cela entraîne un appel récursif de xlAutoClose et un dépassement de capacité de la pile.

N’oubliez pas de supprimer des noms

Si vous avez spécifié l’argument pxFunctionText sur xlfRegister, lors de l’inscription des fonctions et commandes de la DLL, vous devez supprimer explicitement les noms en appelant xlfSetName pour chacun d’eux, en omettant le deuxième argument afin que la fonction n’apparaisse plus dans l’Assistant Fonction. Pour plus d’informations, reportez-vous à la rubrique Problèmes connus concernant le développement de XLL Excel.

Voir aussi