Excel/Excel12f
Gilt für: Excel 2013 | Office 2013 | Visual Studio
Frameworkbibliotheksfunktionen. Excel ist ein Wrapper für die Excel4-Funktion . Excel12f ist ein Wrapper für die Excel12-Funktion . Jedes überprüft, ob keines der Argumente null ist, was darauf hindeutet, dass die Erstellung eines temporären XLOPER - oder XLOPER12 fehlgeschlagen ist. Wenn ein Fehler auftritt, gibt jede eine Debugmeldung aus. Nach Abschluss des Vorgangs gibt jeder den gesamten temporären Arbeitsspeicher frei, der möglicherweise für temporäre XLOPERs und XLOPER12s erstellt wurde.
Excel12f kann nur über eine DLL aufgerufen werden, die mit der Excel 2007 C-API-Bibliothek beginnt. Darüber hinaus funktioniert es nur bei der Ausführung ab Excel 2007, andernfalls tritt xlretFailed auf .
int Excel(int iFunction, LPXLOPER pxRes, int iCount,
LPXLOPER argument1, ...);
int Excel12f(int iFunction, LPXLOPER12 pxRes, int iCount,
LPXLOPER12 argument1, ...);
Parameter
iFunction (int)
Eine Zahl, die den Befehl oder die Funktion angibt, den Sie aufrufen möchten. Weitere Informationen finden Sie unter Excel4/Excel12.
pxRes
Ein Zeiger auf das Ergebnis der ausgewerteten Funktion. Jeglicher Speicher, auf den im Ergebnis verwiesen wird, wurde von Excel zugewiesen und sollte in einem Aufruf von xlFree freigegeben werden, sobald es nicht mehr benötigt wird, oder durch Festlegen von xlbitXLFree , wenn es an Excel zurückgegeben wird.
iCount (int)
Die Anzahl der Argumente, die an die Funktion übergeben werden. Ab Excel 2007 beträgt der Grenzwert 255 Argumente. In früheren Versionen beträgt der Grenzwert 30.
argument1, ...
Die optionalen Argumente für die Funktion. Alle Argumente müssen zeiger auf XLOPERs im Fall von Excel oder XLOPER12s im Fall von Excel12f sein.
Rückgabewert
Beide Funktionen geben die gleichen Fehler- und Erfolgscodes wie Excel4, Excel4v, Excel12 und Excel12v zurück. Eine vollständige Beschreibung dieser Codes finden Sie unter Excel4/Excel12 . Darüber hinaus geben diese Frameworkfunktionen xlretFailed zurück, ohne die C-API aufzurufen, wenn ein NULL-Zeiger auf einen Parameter erkannt wird.
Beispiel
In diesem Beispiel wird ein ungültiges Argument an die Excel12f-Funktion übergeben, die eine Nachricht an den Debugger sendet.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI Excel12fExample(void)
{
Excel12f(xlcDisplay, 0, 1, 0);
return 1;
}