xlAutoRegister/xlAutoRegister12
Gilt für: Excel 2013 | Office 2013 | Visual Studio
Excel ruft die xlAutoRegister-Funktion immer dann auf, wenn ein Aufruf der XLM-Funktion REGISTER oder der C-API-entsprechenden xlfRegister-Funktion erfolgt ist, wobei die Rückgabe- und Argumenttypen der zu registrierenden Funktion fehlen. Damit kann die XLL ihre internen Listen exportierter Funktionen und Befehle durchsuchen, um die Funktion mit dem angegebenen Argument und den angegebenen Rückgabetypen zu registrieren.
Ab Excel 2007 ruft Excel die xlAutoRegister12-Funktion vor der xlAutoRegister-Funktion auf, wenn sie von der XLL exportiert wird.
Excel erfordert keine XLL, um eine dieser Funktionen zu implementieren und zu exportieren.
Hinweis
Wenn xlAutoRegister/ xlAutoRegister12 versucht, die Funktion zu registrieren, ohne das Argument und die Rückgabetypen anzugeben, tritt eine rekursive aufrufende Schleife auf, die schließlich die Aufrufliste überläuft und Excel abstürzt.
LPXLOPER12 WINAPI xlAutoRegister12(LPXLOPER12 pxName);
LPXLOPER WINAPI xlAutoRegister(LPXLOPER pxName);
Parameter
pxName (xltypeStr)
Der Name der XLL-Funktion, die registriert wird.
Eigenschaftswert/Rückgabewert
Die Funktion sollte das Ergebnis des Versuchs zurückgeben, die XLL-Funktion pxName mithilfe der xlfRegister-Funktion zu registrieren. Wenn die angegebene Funktion keiner der XLL-Exporte ist, sollte sie den fehler #VALUE! oder NULL zurückgeben, den Excel bei #VALUE! interpretiert.
Hinweise
Ihre Implementierung von xlAutoRegister sollte eine Suche ohne Berücksichtigung der Groß-/Kleinschreibung durch die internen Listen ihrer XLL-Funktionen und Befehle ausführen, die exportiert werden, um nach einer Übereinstimmung mit dem übergebenen Namen zu suchen. Wenn die Funktion oder der Befehl gefunden wird, sollte xlAutoRegister versuchen, sie mithilfe der xlfRegister-Funktion zu registrieren. Stellen Sie dabei sicher, dass die Zeichenfolge bereitgestellt wird, die Excel die Rückgabe- und Argumenttypen der Funktion sowie alle anderen erforderlichen Informationen über die Funktion angibt. Es sollte dann zu Excel zurückkehren, unabhängig davon, wie der Aufruf von xlfRegister zurückgegeben wurde. Wenn die Funktion erfolgreich registriert wurde, gibt xlfRegister einen xltypeNum-Wert zurück, der die Register-ID der Funktion enthält.
Beispiel
Eine Beispielimplementierung dieser Funktion finden Sie in der -Datei SAMPLES\EXAMPLE\EXAMPLE.C .