Función WinMain (winbase.h)
Punto de entrada proporcionado por el usuario para una aplicación gráfica basada en Windows.
winMain es el nombre convencional que se usa para el punto de entrada de la aplicación. Para obtener más información, vea Comentarios.
Sintaxis
int __clrcall WinMain(
[in] HINSTANCE hInstance,
[in, optional] HINSTANCE hPrevInstance,
[in] LPSTR lpCmdLine,
[in] int nShowCmd
);
Parámetros
[in] hInstance
Tipo: HINSTANCE
Identificador de la instancia actual de la aplicación.
[in, optional] hPrevInstance
Tipo: HINSTANCE
Identificador de la instancia anterior de la aplicación. Este parámetro siempre se NULL. Si necesita detectar si ya existe otra instancia, cree una exclusión mutua con nombre único mediante la función CreateMutex. createMutex se realizará correctamente incluso si la exclusión mutua ya existe, pero la función devolverá ERROR_ALREADY_EXISTS. Esto indica que existe otra instancia de la aplicación, ya que creó primero la exclusión mutua. Sin embargo, un usuario malintencionado puede crear esta exclusión mutua antes de hacerlo e impedir que la aplicación se inicie. Para evitar esta situación, cree una exclusión mutua con nombre aleatorio y almacene el nombre para que un usuario autorizado solo pueda obtenerlo. Como alternativa, puede usar un archivo para este propósito. Para limitar la aplicación a una instancia por usuario, cree un archivo bloqueado en el directorio de perfil del usuario.
[in] lpCmdLine
Tipo: LPSTR de
Línea de comandos de la aplicación, excepto el nombre del programa. Para recuperar toda la línea de comandos, use la función
[in] nShowCmd
Tipo: int
Controla cómo se va a mostrar la ventana. Este parámetro puede ser cualquiera de los valores que se pueden especificar en el parámetro nCmdShow para la función ShowWindow.
Valor devuelto
Tipo: int
Si la función se realiza correctamente, finalizando cuando recibe un mensaje de WM_QUIT, debe devolver el valor de salida incluido en el parámetro wParam wParam. Si la función finaliza antes de escribir el bucle de mensajes, debe devolver cero.
Observaciones
Muchos marcos de programación usan el nombre WinMain. En función del marco de programación, la llamada a la función de WinMain puede ir precedida y seguida de actividades adicionales específicas de ese marco.
El WinMain debe inicializar la aplicación, mostrar su ventana principal y escribir un bucle de recuperación y distribución de mensajes que sea la estructura de control de nivel superior para el resto de la ejecución de la aplicación. Finalice el bucle de mensajes cuando reciba un mensaje de WM_QUIT. En ese momento, el WinMain debe salir de la aplicación y devolver el valor pasado en el parámetro wParam del mensaje WM_QUIT. Si WM_QUIT se recibió como resultado de llamar a PostQuitMessage, el valor de wParam es el valor del parámetro PostQuitMessage de la función nExitCode. Para obtener más información, vea Creación de un bucle de mensajes.
Las aplicaciones ANSI pueden usar el parámetro lpCmdLine de la función WinMain para acceder a la cadena de línea de comandos, excepto el nombre del programa. Tenga en cuenta que
Ejemplo
En el ejemplo de código siguiente se muestra el uso de WinMain
#include <windows.h>
int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE hInstPrev, PSTR cmdline, int cmdshow)
{
return MessageBox(NULL, "hello, world", "caption", 0);
}
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winbase.h (incluya Windows.h) |
Consulte también
conceptual de
otros recursos
de referencia de