XlAddInManagerInfo/xlAddInManagerInfo12 (maschinell übersetzt)
Letzte Änderung: Mittwoch, 18. März 2009
Gilt für: Excel 2010 | Office 2010 | VBA | Visual Studio
Wichtig
Dieser Artikel wurde maschinell übersetzt. Bitte beachten Sie den Haftungsausschluss. Die englische Version des Artikels ist als Referenz hier verfügbar: here.
Wird von Microsoft Excel aufgerufen, wenn der Add-In-Manager in einer Excel-Sitzung zum ersten Mal aufgerufen wird. Mithilfe dieser Funktion werden dem Add-In-Manager Informationen über Ihr Add-In bereitgestellt.
Excel 2007 ruft xlAddInManagerInfo12 vorziehen, xlAddInManagerInfo, wenn von der XLL exportiert. Die xlAddInManagerInfo12-Funktion sollte in die gleiche Weise wie xlAddInManagerInfo zu vermeiden versionsspezifische Unterschiede im Verhalten von der XLL funktionieren. Excel erwartet xlAddInManagerInfo12XLOPER12-Datentyp zurückgeben, während xlAddInManagerInfo ein XLOPER zurückgeben soll.
xlAddInManagerInfo12-Funktion wird nicht von früheren Versionen von Excel als Excel 2007, aufgerufen, wie diese nicht die XLOPER12 unterstützen.
Excel erfordert eine XLL implementieren und exportieren diese Funktionen nicht.
LPXLOPER WINAPI xlAddInManagerInfo(LPXLOPER pxAction);
LPXLOPER12 WINAPI xlAddInManagerInfo12(LPXLOPER12 pxAction);
Parameter
pxAction: A-Zeiger auf eine numerische XLOPER/XLOPER12 (xltypeInt oder xltypeNum).
Die Informationen, der für Excel gefragt ist.
Eigenschaftswert/Rückgabewert
Wenn pxAction oder um die Zahl 1 umgewandelt werden kann, sollte die Implementierung dieser Funktion eine Zeichenfolge mit einigen Informationen über das Add-in, in der Regel seinen Namen und vielleicht eine Versionsnummer zurückgeben. Andernfalls sollte es # Value zurück!.
Wenn Sie keine Zeichenfolge zurückgeben, versucht Excel den zurückgegebenen Wert in eine Zeichenfolge konvertieren.
Hinweis
Haftungsausschluss für maschinelle Übersetzungen: Dieser Artikel wurde mithilfe eines Computersystems und ohne jegliche Bearbeitung durch Personen übersetzt. Microsoft bietet solche maschinellen Übersetzungen als Hilfestellung für Benutzer ohne Englischkenntnisse an, damit Sie von den Informationen zu Produkten, Diensten und Technologien von Microsoft profitieren können. Da es sich bei diesem Artikel um eine maschinelle Übersetzung handelt, enthält er möglicherweise Fehler in Bezug auf (Fach-)Terminologie, Syntax und/oder Grammatik.
Hinweise
Wenn die zurückgegebene Zeichenfolge dynamisch zugewiesenen Puffers verweist, müssen Sie sicherstellen, dass dieses Puffers schließlich freigegeben ist. Wenn die Zeichenfolge von Excel zugeordnet war, dazu Sie xlbitXLFree festlegen. Wenn die Zeichenfolge von der DLL reserviert wurde, dazu xlbitDLLFree festlegen und Sie auch in xlAutoFree implementieren müssen (Wenn Sie ein XLOPER zurückgeben) oder xlAutoFree12 (Wenn Sie ein XLOPER12 zurückgeben).
Beispiel
\SAMPLES\GENERIC\GENERIC.C
LPXLOPER12 WINAPI xlAddInManagerInfo12(LPXLOPER12 xAction)
{
static XLOPER12 xInfo, xIntAction;
/*
** This code coerces the passed-in value to an integer. This is how the
** code determines what is being requested. If it receives a 1, it returns a
** string representing the long name. If it receives anything else, it
** returns a #VALUE! error.
*/
Excel12f(xlCoerce, &xIntAction, 2, xAction, TempInt12(xltypeInt));
if(xIntAction.val.w == 1)
{
xInfo.xltype = xltypeStr;
xInfo.val.str = L"\026Example Standalone DLL";
}
else
{
xInfo.xltype = xltypeErr;
xInfo.val.err = xlerrValue;
}
// Word of caution - returning static XLOPERs/XLOPER12s is not thread safe
// for UDFs declared as thread safe. Use alternate memory allocation mechanisms.
return (LPXLOPER12)&xInfo;
}
Siehe auch
Konzepte
Add-in-Manager und XLL-Schnittstellenfunktionen (maschinell übersetzt)