Función ShellMessageBoxA (shellapi.h)
[ShellMessageBox está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.]
ShellMessageBox es una instancia especial de MessageBox que proporciona la opción de usar el título de la ventana del propietario como título del cuadro de mensaje.
Sintaxis
int ShellMessageBoxA(
[in] HINSTANCE hAppInst,
[in] HWND hWnd,
[in] LPCSTR lpcText,
[in] LPCSTR lpcTitle,
[in] UINT fuStyle,
...
);
Parámetros
[in] hAppInst
Tipo: HINSTANCE
Identificador del módulo desde el que se carga un recurso de cadena denominado en pszTitle. Si pszTitle no asigna un nombre a un recurso de cadena, se omite este parámetro. Este valor debe ser válido si pszMsg o pszTitle es un identificador de recurso.
[in] hWnd
Tipo: HWND
Identificador de la ventana de propietario del cuadro de mensaje que se va a crear. Si esta variable no es NULL, el título de la ventana del propietario se usa como título del cuadro de mensaje.
[in] lpcText
Tipo: LPCTSTR de
Puntero a una cadena terminada en null que contiene el mensaje que se va a mostrar o un identificador de recurso que especifica dónde se va a recuperar el mensaje.
[in] lpcTitle
Tipo: LPCTSTR de
Puntero a una cadena terminada en null que contiene el título del cuadro de diálogo o un identificador de recurso que especifica dónde se va a recuperar el título. Si tanto este parámetro como hWnd son NULL, no se muestra ningún título. Si este parámetro apunta a un recurso que se puede cargar con la macro MAKEINTRESOURCE, invalida hWnd como título.
[in] fuStyle
Tipo: UINT
Especifica el contenido y el comportamiento del cuadro de diálogo. Para ver los valores posibles, consulte cuadro de mensajes.
...
Lista de argumentos variables que se combina con pszMsg para formar el texto completo que se muestra en el cuadro de mensaje.
Valor devuelto
Tipo: int
Valor entero que indica un botón que se presionó en el cuadro de mensaje. Para obtener valores específicos, consulte cuadro de mensajes.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Nota
El encabezado shellapi.h define ShellMessageBox como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
shellapi.h |
| biblioteca de |
Shlwapi.lib |
| DLL de |
Shlwapi.dll |