xlAutoRegister/xlAutoRegister12
Hace referencia a: Excel 2013 | Office 2013 | Visual Studio
Excel llama a la función xlAutoRegister cada vez que se ha realizado una llamada a la función XLM REGISTER o a la función xlfRegister equivalente a la API de C, con los tipos de argumento y devolución de la función que faltan. Permite que el XLL busque en sus listas internas de funciones y comandos exportados para registrar la función con los tipos de argumento y valor devuelto especificados.
A partir de Excel 2007, Excel llama a la función xlAutoRegister12 en preferencia a la función xlAutoRegister si la exporta XLL.
Excel no requiere un XLL para implementar y exportar ninguna de estas funciones.
Nota:
Si xlAutoRegister/ xlAutoRegister12 intenta registrar la función sin proporcionar los tipos de argumento y valor devuelto, se produce un bucle de llamada recursivo que finalmente desborda la pila de llamadas y bloquea Excel.
LPXLOPER12 WINAPI xlAutoRegister12(LPXLOPER12 pxName);
LPXLOPER WINAPI xlAutoRegister(LPXLOPER pxName);
Parameters
pxName (xltypeStr)
Nombre de la función XLL que se está registrando.
Valor de la propiedad/valor devuelto
La función debe devolver el resultado del intento de registrar la función XLL pxName mediante la función xlfRegister . Si la función especificada no es una de las exportaciones del XLL, debe devolver el error #VALUE! o NULL que Excel interpretará en #VALUE!.
Comentarios
La implementación de xlAutoRegister debe realizar una búsqueda sin distinción entre mayúsculas y minúsculas a través de las listas internas del XLL de las funciones y los comandos que exporta en busca de una coincidencia con el nombre pasado. Si se encuentra la función o el comando, xlAutoRegister debe intentar registrarla mediante la función xlfRegister , asegurándose de proporcionar la cadena que indica a Excel los tipos de argumento y valor devuelto de la función, así como cualquier otra información necesaria sobre la función. A continuación, debe volver a Excel sea cual sea la llamada a xlfRegister devuelta. Si la función se registró correctamente, xlfRegister devuelve un valor xltypeNum que contiene el identificador de registro de la función.
Ejemplo
Consulte el archivo SAMPLES\EXAMPLE\EXAMPLE.C para obtener una implementación de ejemplo de esta función.