Excel/Excel12f
S’applique à: Excel 2013 | Office 2013 | Visual Studio
Fonctions de bibliothèque d’infrastructure. Excel est un wrapper pour la fonction Excel4 . Excel12f est un wrapper pour la fonction Excel12 . Chaque vérifie qu’aucun des arguments n’est égal à zéro, ce qui indiquerait que la création d’un XLOPER temporaire ou d’un XLOPER12 a échoué. Si une erreur se produit, chacun imprime un message de débogage. Lorsque vous avez terminé, chacun libère toute la mémoire temporaire qui a pu être créée pour les XLOPERtemporaires et les XLOPER12.
Excel12f ne peut être appelé qu’à partir d’une DLL à partir de la bibliothèque d’API Excel 2007 C. En outre, il fonctionne uniquement lors de l’exécution à partir d’Excel 2007, et échoue avec xlretFailed dans le cas contraire.
int Excel(int iFunction, LPXLOPER pxRes, int iCount,
LPXLOPER argument1, ...);
int Excel12f(int iFunction, LPXLOPER12 pxRes, int iCount,
LPXLOPER12 argument1, ...);
Paramètres
iFunction (int)
Nombre indiquant la commande ou la fonction que vous souhaitez appeler. Pour plus d’informations, voir Excel4/Excel12.
pxRes
Pointeur vers le résultat de la fonction évaluée. Toute mémoire pointée vers le résultat aura été allouée par Excel et doit être libérée dans un appel à xlFree une fois qu’elle n’est plus nécessaire, ou en définissant xlbitXLFree si elle est retournée à Excel.
iCount (int)
Nombre d’arguments qui seront passés à la fonction. À compter d’Excel 2007, la limite est de 255 arguments. Dans les versions antérieures, la limite est de 30.
argument1, ...
Arguments facultatifs de la fonction. Tous les arguments doivent être des pointeurs vers XLOPERdans le cas d’Excel, ou des XLOPER12dans le cas d’Excel12f.
Valeur renvoyée
Les deux fonctions retournent les mêmes codes d’erreur et de réussite qu’Excel4, Excel4v, Excel12 et Excel12v. Pour obtenir une description complète de ces codes, voir Excel4/Excel12 . En outre, ces fonctions framework retournent xlretFailed sans appeler l’API C si un pointeur NULL vers un paramètre est détecté.
Exemple
Cet exemple transmet un argument incorrect à la fonction Excel12f , qui envoie un message au débogueur.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI Excel12fExample(void)
{
Excel12f(xlcDisplay, 0, 1, 0);
return 1;
}