Cómo: Implementar funciones de devolución de llamada

El siguiente procedimiento y el ejemplo incluido muestran la forma en que una aplicación administrada, utilizando la invocación de plataforma, puede imprimir el valor del identificador de cada ventana en el equipo local. Concretamente, utilizan la función EnumWindows para recorrer paso a paso la lista de ventanas y se utiliza una función de devolución de llamada administrada (denominada CallBack) para imprimir el valor del identificador de ventana.

Para implementar una función de devolución de llamada

1. Observe el prototipo de la función EnumWindows antes de continuar con la implementación. EnumWindows tiene el siguiente prototipo:

   BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)
   

   Una pista para saber que esta función requiere una devolución de llamada es la presencia del argumento lpEnumFunc. Es frecuente ver el prefijo lp (puntero largo) combinado con el sufijo Func en el nombre de los argumentos que tienen un puntero a una función de devolución de llamada. Para obtener la documentación de las funciones de Win32, vea Platform SDK.

2. Cree la función de devolución de llamada administrada. En el ejemplo se declara un tipo de delegado, denominado CallBack, que toma dos argumentos (hwnd e Iparam). El primer argumento es un identificador de la ventana; el segundo, viene definido por la aplicación. En esta versión, los dos argumentos tienen que ser enteros.

   Generalmente, las funciones de devolución de llamada devuelven valores distintos de cero para indicar que se ha realizado correctamente y cero para indicar que se ha producido un error. En este ejemplo, el valor devuelto se establece explícitamente en true para continuar la enumeración.

3. Cree un delegado y páseselo como argumento a la función EnumWindows. La invocación de plataforma convierte automáticamente el delegado a un formato de devolución de llamada conocido.

4. Asegúrese de que el recolector de elementos no utilizados no reclama el delegado antes de que la función de devolución de llamada complete su tarea. Cuando pase un delegado como parámetro, o pase un delegado contenido como campo en una estructura, se queda si recoger mientras dure la llamada. Por lo tanto, tal como ocurre en el siguiente ejemplo de enumeración, la función de devolución de llamada completa su tarea antes de que vuelva la llamada y no es necesaria ninguna acción adicional por parte del llamador administrado.

   No obstante, si se puede invocar la función de devolución de llamada después de que vuelva la llamada, el llamador administrado debe seguir los pasos para asegurarse de que el delegado sigue sin recoger hasta que la función de devolución de llamada acaba. Para obtener información detallada sobre cómo evitar la recolección de elementos no utilizados, vea Cálculo de referencias interoperativo con invocación de plataforma.

Ejemplo

Imports System
Imports System.Runtime.InteropServices

Public Delegate Function CallBack( _
hwnd As Integer, lParam As Integer) As Boolean

Public Class EnumReportApp

    Declare Function EnumWindows Lib "user32" ( _
       x As CallBack, y As Integer) As Integer

    Public Shared Sub Main()
        EnumWindows(AddressOf EnumReportApp.Report, 0)
    End Sub 'Main

    Public Shared Function Report(hwnd As Integer, lParam As Integer) _
    As Boolean
        Console.Write("Window handle is ")
        Console.WriteLine(hwnd)
        Return True
    End Function 'Report
End Class 'EnumReportApp

using System;
using System.Runtime.InteropServices;

public delegate bool CallBack(int hwnd, int lParam);

public class EnumReportApp
{
    [DllImport("user32")]
    public static extern int EnumWindows(CallBack x, int y); 

    public static void Main() 
    {
        CallBack myCallBack = new CallBack(EnumReportApp.Report);
        EnumWindows(myCallBack, 0);
    }

    public static bool Report(int hwnd, int lParam)
    { 
        Console.Write("Window handle is ");
        Console.WriteLine(hwnd);
        return true;
    }
}

using namespace System;
using namespace System::Runtime::InteropServices;

// A delegate type.
delegate bool CallBack(int hwnd, int lParam);

// Managed type with the method to call.
ref class EnumReport
{
// Report the window handle.
public:
    [DllImport("user32")]
    static int EnumWindows(CallBack^ x, int y);
    
    static void Main()
    {
        EnumReport^ er = gcnew EnumReport;
        CallBack^ myCallBack = gcnew CallBack(&EnumReport::Report);
        EnumWindows(myCallBack, 0);
    }

    static bool Report(int hwnd, int lParam)
    {
       Console::Write(L"Window handle is ");
       Console::WriteLine(hwnd);
       return true;
    }
};

int main()
{
    EnumReport::Main();
}

Vea también

Conceptos

Funciones de devolución de llamada

Otros recursos

Llamar a una función DLL