Función OleUIPromptUserW (oledlg.h)
Muestra un cuadro de diálogo con la plantilla especificada y devuelve la respuesta (identificador de botón) del usuario. Esta función se usa para mostrar mensajes de advertencia OLE, por ejemplo, Clase no registrada.
Sintaxis
int OleUIPromptUserW(
[in] int nTemplate,
[in] HWND hwndParent,
...
);
Parámetros
[in] nTemplate
Número de recurso del cuadro de diálogo que se va a mostrar. Vea la sección Comentarios.
[in] hwndParent
Identificador de la ventana primaria del cuadro de diálogo.
...
Opcional. Título del cuadro de diálogo seguido de una lista de argumentos para la cadena de formato en el control estático (IDC_PU_TEXT) del cuadro de diálogo. El autor de la llamada debe asegurarse de pasar el número y los tipos correctos de argumentos.
Valor devuelto
Definiciones de errores o correctos estándar
Código devuelto | Descripción |
---|---|
|
Error desconocido (sin usar). |
|
El usuario ha presionado el botón Aceptar . |
|
No hay ningún error, igual que OLEUI_OK. |
|
El usuario presionó el botón Cancelar . |
Errores de validación de campos estándar
Código devuelto | Descripción |
---|---|
|
Los errores comunes a todos los cuadros de diálogo se encuentran en el intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Este valor permite a la aplicación probar los mensajes estándar para mostrar los mensajes de error al usuario. |
|
El puntero a una estructura OLEUIXXX pasada a la función era NULL. |
|
Permisos insuficientes para el acceso de lectura o escritura a una estructura OLEUIXXX. |
|
El valor cbstruct es incorrecto. |
|
El valor hWndOwner no es válido. |
|
El valor lpszCaption no es válido. |
|
El valor de lpfnHook no es válido. |
|
El valor hInstance no es válido. |
|
El valor lpszTemplate no es válido. |
|
El valor hResource no es válido. |
Errores de inicialización
Código devuelto | Descripción |
---|---|
|
No se encuentra la plantilla del cuadro de diálogo. |
|
No se puede cargar la plantilla del cuadro de diálogo. |
|
Error de inicialización del cuadro de diálogo. |
|
Error en una llamada a LocalAlloc o al asignador IMalloc estándar. |
|
Error en una llamada a GlobalAlloc o al asignador IMalloc estándar. |
|
No se puede llamar a LoadString para recursos localizados desde la biblioteca. |
|
Error en una llamada al asignador IMalloc estándar. |
Errores específicos de la función
Código devuelto | Descripción |
---|---|
|
Los errores comunes a todos los cuadros de diálogo se encuentran en el intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Este valor permite a la aplicación probar los mensajes estándar para mostrar los mensajes de error al usuario. |
Comentarios
Las siguientes plantillas de cuadro de diálogo se definen en Directrices de la interfaz de Windows: Guía de diseño de software. El parámetro nTemplate debe ser un recurso definido actualmente; sin embargo, se pueden agregar plantillas adicionales a prompt.dlg.
IDD_LINKSOURCEUNAVAILABLE
IDD_CANNOTUPDATELINK
IDD_SERVERNOTREG
IDD_CANNOTRESPONDVERB
IDD_SERVERNOTFOUND
Nota
El encabezado oledlg.h define OleUIPromptUser 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 Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | oledlg.h |
Library | OleDlg.lib |
Archivo DLL | OleDlg.dll |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de