xlAutoRegister/xlAutoRegister12
S’applique à: Excel 2013 | Office 2013 | Visual Studio
Excel appelle la fonction xlAutoRegister chaque fois qu’un appel a été effectué à la fonction XLM REGISTER ou à la fonction xlfRegister équivalente à l’API C, avec les types de retour et d’argument de la fonction en cours d’inscription manquants. Il permet au XLL de rechercher dans ses listes internes de fonctions exportées et de commandes pour inscrire la fonction avec les types d’argument et de retour spécifiés.
À compter d’Excel 2007, Excel appelle la fonction xlAutoRegister12 de préférence à la fonction xlAutoRegister si elle est exportée par le XLL.
Excel n’a pas besoin d’un XLL pour implémenter et exporter l’une ou l’autre de ces fonctions.
Remarque
Si xlAutoRegister/ xlAutoRegister12 tente d’inscrire la fonction sans fournir les types d’argument et de retour, une boucle d’appel récursive se produit qui finit par dépasser la pile des appels et bloque Excel.
LPXLOPER12 WINAPI xlAutoRegister12(LPXLOPER12 pxName);
LPXLOPER WINAPI xlAutoRegister(LPXLOPER pxName);
Paramètres
pxName (xltypeStr)
Nom de la fonction XLL en cours d’inscription.
Valeur de propriété/valeur de renvoi
La fonction doit retourner le résultat de la tentative d’inscription de la fonction XLL pxName à l’aide de la fonction xlfRegister . Si la fonction spécifiée ne fait pas partie des exportations xll, elle doit retourner l’erreur #VALUE ! ou NULL qu’Excel interprétera à #VALUE !.
Remarques
Votre implémentation de xlAutoRegister doit effectuer une recherche qui ne respecte pas la casse dans les listes internes de votre XLL des fonctions et des commandes qu’elle exporte à la recherche d’une correspondance avec le nom passé. Si la fonction ou la commande est trouvée, xlAutoRegister doit tenter de l’inscrire à l’aide de la fonction xlfRegister , en veillant à fournir la chaîne qui indique à Excel les types de retour et d’argument de la fonction, ainsi que toutes les autres informations requises sur la fonction. Il doit ensuite revenir à Excel, quel que soit l’appel à xlfRegister retourné. Si la fonction a été inscrite avec succès, xlfRegister renvoie une valeur xltypeNum contenant l’ID register de la fonction.
Exemple
Consultez le fichier SAMPLES\EXAMPLE\EXAMPLE.C pour obtenir un exemple d’implémentation de cette fonction.