Uso de las funciones LLAMAR y REGISTRAR

Tipos de datos F y G

Con los tipos de datos F y G, una función puede modificar un búfer de cadena que esté asignado por Microsoft Excel. Si el código de tipo de retorno es F o G, Microsoft Excel descarta el valor devuelto por la función. En lugar de este valor, Microsoft Excel busca en la lista de argumentos de función el primer tipo de datos correspondiente (F o G) y toma el contenido actual del búfer de cadena asignado como valor de retorno. Microsoft Excel asigna 256 bytes para el argumento, de forma que la función puede devolver una cadena más larga que la que recibió.

Principio de página

Tipo de datos K

El tipo de datos K usa un puntero para una estructura FP de tamaño variable. Debe definir esta estructura en el archivo DLL o recursos de código como sigue:

typedef struct _FP
{
    unsigned short int rows;
    unsigned short int columns;
    double array[1];        /* Actually, array[rows][columns] */
} FP;

La declaración double array[1] únicamente asigna el almacenamiento para una matriz de un solo elemento. El número de elementos de la matriz real es igual al número de filas multiplicado por el número de columnas.

Principio de página

Tipo de datos O

El tipo de datos O solo puede usarse como argumento, no como valor de retorno. Pasa tres elementos: un puntero para el número de filas de una matriz, un puntero para el número de columnas de una matriz y un puntero para una matriz bidimensional de números de coma flotante.

En lugar de devolver un valor, una función puede modificar una matriz pasada por el tipo de datos O. Para ello, puede usar ">O" como argumento tipo. Para más información, vea más adelante "Modificar in situ. Funciones declaradas como Void".

El tipo de datos O se creó para que fuera compatible directamente con los archivos DLL Fortran, que pasan argumentos por referencia.

Principio de página

Tipo de datos P

El tipo de datos P es un puntero para una estructura OPER. La estructura OPER contiene 8 bytes de datos, seguidos por un identificador de 2 bytes que especifica el tipo de datos. Con el tipo de datos P, una función de DLL o recurso de códigos puede tomar y devolver cualquier tipo de datos de Microsoft Excel.

La estructura OPER se define como sigue:

typedef struct _oper

{
    union
    {
        double num;
        unsigned char *str;
        unsigned short int bool;
        unsigned short int err;
        struct
        {
            struct _oper *lparray;
            unsigned short int rows;
            unsigned short int columns;
        } array;
    } val;
    unsigned short int type;
} OPER;

El campo Tipo contiene uno de estos valores.

Los dos últimos valores solo pueden usarse como argumentos, no como valores de retorno. El valor de argumento no encontrado (128) se pasa cuando quien realiza la llamada omite un argumento. El valor de celda vacía (256) se pasa cuando quien realiza la llamada pasa una referencia a una celda vacía.

Principio de página

Tipo de datos R. Llamar a funciones de Microsoft Excel desde archivos DLL

El tipo de datos R es un puntero a una estructura XLOPER, que es una versión mejorada de la estructura OPER. En Microsoft Excel versión 4.0 y posteriores, puede usar el tipo de datos R para crear archivos DLL y recursos de código que llamen a funciones de Microsoft Excel. Con la estructura XLOPER, una función de DLL puede pasar referencias de hojas y efectuar control de flujo, además de pasar datos. La descripción exhaustiva del tipo de datos R y de la interfaz de programación de Microsoft Excel (API) queda fuera del ámbito de este tema. La guía Microsoft Office XP Developer's Guide (disponible solo en inglés) contiene información detallada sobre el tipo de datos R, la interfaz de programación de Microsoft Excel (API) y muchos otros aspectos técnicos de Microsoft Excel.

Principio de página

Funciones volátiles y actualización

Por lo general, Microsoft Excel calcula una función de DLL (o un recurso de código) solo cuando se especifica en una celda, cuando uno de sus precedentes cambia o cuando la celda se calcula durante una macro. En una hoja de cálculo puede convertir en volátil una función de DLL o un recurso de código; es decir, se actualiza cada vez que se actualiza la hoja de cálculo. Para hacer una función volátil, agregue un signo de exclamación (!) como último carácter del argumento tipo.

Por ejemplo, en Microsoft Excel para Windows, la fórmula de hoja de cálculo siguiente se actualiza cada vez que se actualiza la hoja de cálculo:

LLAMAR("Kernel32","GetTickCount","J!")

Principio de página

Modificar in situ. Funciones declaradas como Void

Puede usar un solo dígito n para el código de tipo devuelto en tipo, donde n es un número del 1 al 9. Esto indica a Microsoft Excel que modifique la variable en la ubicación indicada por el argumento enésimo de tipo, en vez de devolver un valor. Esto se conoce también como modificar in situ. El argumento enésimo debe ser un tipo de datos de pase por referencia (C, D, E, F, G, K, L, M, N, O, P o R). La función de DLL o el recurso de código debe poder declararse igualmente con la palabra clave void en lenguaje C (o la palabra clave procedure en lenguaje Pascal).

Por ejemplo, una función de DLL que toma una cadena terminada con carácter nulo y dos punteros a enteros como argumentos puede modificar la cadena in situ. Use "1FMM" como argumento tipo y declare la función como void.

Las versiones anteriores a Microsoft Excel 4.0 usaban el carácter > para modificar el primer argumento in situ: solo se podía modificar el primer argumento. El carácter > es equivalente a n = 1 en Microsoft Excel versión 4.0 y posteriores.

Principio de página