Compartir a través de

Función OleUIBusyA (oledlg.h)

  • Artículo

Invoca el cuadro de diálogo estándar Ocupado, lo que permite al usuario administrar la simultaneidad.

Sintaxis

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Parámetros

[in] unnamedParam1

Puntero a una estructura OLEUIBUSY que contiene información utilizada para inicializar el cuadro de diálogo.

Valor devuelto

Esta función devuelve los siguientes valores:

Definiciones de errores y correctos estándar

Código devuelto Descripción
OLEUI_FALSE
 Error desconocido (sin usar).
OLEUI_SUCCESS
 No hay ningún error, igual que OLEUI_OK.
OLEUI_OK
 El usuario ha presionado el botón Aceptar.
OLEUI_CANCEL
 El usuario ha presionado el botón Cancelar y que el autor de la llamada debe cancelar la operación.
OLEUI_BZ_SWITCHTOSELECTED
 El usuario ha presionado Cambiar a y OleUIBusy no pudo determinar cómo cambiar a la aplicación de bloqueo. En este caso, el autor de la llamada debe tomar medidas para intentar resolver el conflicto en sí, si es posible, o reintentar la operación. oleUIBusy solo devolverá OLEUI_BZ_SWITCHTOSELECTED si el usuario ha presionado el botón Cambiar a, hTask es NULL y se establece la marca de BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED
 El usuario ha presionado Cambiar a y OleUIBusy no pudo determinar cómo cambiar a la aplicación de bloqueo. En este caso, el autor de la llamada debe tomar medidas para intentar resolver el conflicto en sí, si es posible, o reintentar la operación. oleUIBusy solo devolverá OLEUI_BZ_SWITCHTOSELECTED si el usuario ha presionado el botón Cambiar a, hTask es NULL y se establece la marca de BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED
 El usuario ha presionado Cambiar a y OleUIBusy no pudo determinar cómo cambiar a la aplicación de bloqueo. En este caso, el autor de la llamada debe tomar medidas para intentar resolver el conflicto en sí, si es posible, o reintentar la operación. oleUIBusy solo devolverá OLEUI_BZ_SWITCHTOSELECTED si el usuario ha presionado el botón Cambiar a, hTask es NULL y se establece la marca de BZ_NOTRESPONDING.
OLEUI_BZ_RETRYSELECTED
El usuario ha presionado el botón Reintentar o ha intentado resolver el conflicto (probablemente cambiando a la aplicación de bloqueo). En este caso, el autor de la llamada debe reintentar la operación.
OLEUI_BZ_CALLUNBLOCKED
El cuadro de diálogo se ha informado de que la operación ya no está bloqueada.
 

Errores de validación de campos estándar

Código devuelto Descripción
OLEUI_ERR_STANDARDMIN
 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.
OLEUI_ERR_STRUCTURENULL
 El puntero a una estructura OLEUIXXX pasada a la función era NULL.
OLEUI_ERR_STRUCTUREINVALID
 Permisos insuficientes para el acceso de lectura o escritura a una estructura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
El valor cbstruct es incorrecto.
OLEUI_ERR_HWNDOWNERINVALID
 El hWndOwner no es válido.
OLEUI_ERR_LPSZCAPTIONINVALID
 El valor de lpszCaption no es válido.
OLEUI_ERR_LPFNHOOKINVALID
 El valor de lpfnHook no es válido.
OLEUI_ERR_HINSTANCEINVALID
 El hInstance no es válido.
OLEUI_ERR_LPSZTEMPLATEINVALID
 El valor de lpszTemplate no es válido.
OLEUI_ERR_HRESOURCEINVALID
 El valor de hResource no es válido.
 

Errores de inicialización

Código devuelto Descripción
OLEUI_ERR_FINDTEMPLATEFAILURE
 No se puede encontrar la plantilla del cuadro de diálogo.
OLEUI_ERR_LOADTEMPLATEFAILURE
 No se puede cargar la plantilla del cuadro de diálogo.
OLEUI_ERR_DIALOGFAILURE
 Error de inicialización del cuadro de diálogo.
OLEUI_ERR_LOCALMEMALLOC
 Error de llamada a localAlloc o al asignador estándar IMalloc.
OLEUI_ERR_GLOBALMEMALLOC
 No se pudo realizar una llamada a GlobalAlloc o al asignador estándar IMalloc.
OLEUI_ERR_LOADSTRING
 No se puede llamar a LoadString para los recursos localizados de la biblioteca.
OLEUI_ERR_OLEMEMALLOC
 Error en una llamada al asignador estándar IMalloc.
 

Errores específicos de la función

Código devuelto Descripción
OLEUI_ERR_STANDARDMAX
 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.
OLEUI_BZERR_HTASKINVALID
 El hTask especificado en el miembro hTask de la estructura OLEUIBUSY no es válido.

Observaciones

El cuadro de diálogo ole Server estándar Ocupado notifica al usuario que la aplicación de servidor no recibe mensajes. A continuación, el cuadro de diálogo pide al usuario que cancele la operación, cambie a la tarea bloqueada o continúe esperando.

Nota

El encabezado oledlg.h define OLEUIBUSY 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 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 oledlg.h
biblioteca de OleDlg.lib
DLL de OleDlg.dll

Consulte también

OLEUIBUSY