xlfUnregister (forme 1) (traduction automatique)

Article
09/24/2014

Dernière modification : mercredi 18 mars 2009

S’applique à : Excel 2010 | Office 2010 | VBA | Visual Studio

Important

Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Est appelable depuis une commande DLL ou XLL elle-même appelée par Microsoft Excel. Cela équivaut à l’appel UNREGISTER depuis une feuille macro XLM Excel.

xlfUnregister peut être appelée sous deux formes :

Formulaire n° 1: Annule l'inscription d'une fonction ou une commande individuelle.
Formulaire 2: Décharge et désactive un XLL.

Appelé dans le formulaire 1, cette fonction permet de réduire le nombre d'utilisations d'une fonction DLL ou une commande qui était inscrit à l'aide de xlfRegister ou REGISTER. Si le décompte d'utilisation est déjà égal à zéro, cette fonction n'a aucun effet. Lorsque le compteur d'utilisation de toutes les fonctions d'une DLL atteint zéro, la DLL est déchargée de la mémoire.

xlfRegister (formulaire 1) définit également un nom masqué qui est l'argument texte fonction, pxFunctionText, et qui est évalué à la fonction ou ID de l'enregistrement. de la commande Lors de la désinscription de la fonction, ce nom doit être supprimé à l'aide de xlfSetName afin que le nom de fonction n'est plus répertorié par l'Assistant fonction. Pour plus d'informations, consultez Problèmes de développement XLL Excel connus (traduction automatique).

Excel4(xlfUnregister, LPXLOPER pxRes, 1, LPXLOPER pxRegisterId);

Paramètres

pxRegisterId (xltypeNum)

L'ID d'enregistrement de la fonction doit être annulée.

Valeur de propriété/Valeur renvoyée

En cas de réussite, cette propriété renvoie le TRUE (xltypeBool), sinon elle renvoie la valeur FALSE.

Notes

Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Remarques

L'enregistrement de QU'ID de la fonction est retourné par xlfRegister lorsque la fonction est le premier enregistré. Il peut également être obtenue en appelant le xlfRegisterId function ou le xlfEvaluate function. Notez que xlfRegisterId essaie d'enregistrer la fonction si elle n'a pas encore été inscrit. Pour cette raison, si vous souhaitez seulement obtenir l'ID de manière à ce que vous pouvez annuler l'inscription de la fonction, il est préférable obtenir en passant le nom enregistré à xlfEvaluate. Si la fonction n'a pas été enregistrée, xlfEvaluate échoue avec une erreur # nom ? erreur.

Exemple

Voir le code de la fonction fExit dans \SAMPLES\GENERIC\GENERIC.C.

int WINAPI fExit(void)
{
   XLOPER12  xDLL,    // The name of this DLL //
   xFunc,             // The name of the function //
   xRegId;            // The registration ID //
   int i;

//
// This code gets the DLL name. It then uses this along with information
// from g_rgFuncs[] to obtain a REGISTER.ID() for each function. The
// register ID is then used to unregister each function. Then the code
// frees the DLL name and calls xlAutoClose.
//

   // Make xFunc a string //
   xFunc.xltype = xltypeStr;

   Excel12f(xlGetName, &xDLL, 0);

   for (i = 0; i < g_rgWorksheetFuncsRows; i++)
   {
      xFunc.val.str = (LPWSTR) (g_rgWorksheetFuncs[i][0]);
      Excel12f(xlfRegisterId,&xRegId,2,(LPXLOPER12)&xDLL,(LPXLOPER12)&xFunc);
      Excel12f(xlfUnregister, 0, 1, (LPXLOPER12) &xRegId);
   }

   for (i = 0; i < g_rgCommandFuncsRows; i++)
   {
      xFunc.val.str = (LPWSTR) (g_rgCommandFuncs[i][0]);
      Excel12f(xlfRegisterId,&xRegId,2,(LPXLOPER12)&xDLL,(LPXLOPER12)&xFunc);
      Excel12f(xlfUnregister, 0, 1, (LPXLOPER12) &xRegId);
   }

   Excel12f(xlFree, 0, 1,  (LPXLOPER12) &xDLL);

   return xlAutoClose();
}