Función OleUIConvertA (oledlg.h)

  • Artículo

Invoca el cuadro de diálogo Convertir estándar, lo que permite al usuario cambiar el tipo de un único objeto especificado o el tipo de todos los objetos OLE de la clase del objeto especificado.

Sintaxis

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

Parámetros

[in] unnamedParam1

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

Valor devuelto

Definiciones de errores o correctos estándar

Código devuelto Descripción
OLEUI_FALSE
 Error desconocido (sin usar).
OLEUI_OK
 El usuario ha presionado el botón Aceptar.
OLEUI_SUCCESS
 No hay ningún error, igual que OLEUI_OK.
OLEUI_CANCEL
 El usuario ha presionado el botón Cancelar.
 

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 valor hWndOwner no es válido.
OLEUI_ERR_LPSZCAPTIONINVALID
 El valor lpszCaption no es válido.
OLEUI_ERR_LPFNHOOKINVALID
 El valor lpfnHook no es válido.
OLEUI_ERR_HINSTANCEINVALID
 El valor hInstance no es válido.
OLEUI_ERR_LPSZTEMPLATEINVALID
 El valor lpszTemplate no es válido.
OLEUI_ERR_HRESOURCEINVALID
 El valor hResource no es válido.
 

Errores de inicialización

Código devuelto Descripción
OLEUI_ERR_FINDTEMPLATEFAILURE
 No se encuentra 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 al llamar a LocalAlloc o al asignador IMalloc estándar.
OLEUI_ERR_GLOBALMEMALLOC
 Error al llamar a GlobalAlloc o al asignador IMalloc estándar.
OLEUI_ERR_LOADSTRING
 No se puede llamar a LoadString para recursos localizados desde la biblioteca.
OLEUI_ERR_OLEMEMALLOC
 Error al asignador IMalloc estándar.
 

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_CTERR_CLASSIDINVALID
 Un valor clsid no era válido.
OLEUI_CTERR_DVASPECTINVALID
 El valor dvAspect no era válido. Este miembro especifica el aspecto del objeto .
OLEUI_CTERR_CBFORMATINVALID
 El valor wFormat no era válido. Este miembro especifica el formato de datos del objeto .
OLEUI_CTERR_STRINGINVALID
 Un valor de cadena (por ejemplo, lpszUserType o lpszDefLabel) no era válido.

Comentarios

OleUIConvert rellena el cuadro de lista del cuadro de diálogo Convertir con clases de objeto cruzando el Registro y buscando entradas en las claves legibles y legibles. Cada clase que incluye el formato de archivo predeterminado de la clase original en su clave legible se agrega a la lista Convertir, y cada clase que incluye el formato de archivo predeterminado de la clase original en su clave ReadWritable se agrega a la lista Activar como. La lista Convertir se muestra en el cuadro de lista del cuadro de diálogo cuando se selecciona el botón de radio Convertir (la selección predeterminada) y se muestra la lista Activar como cuando se selecciona Activar como .

Tenga en cuenta que puede cambiar el tipo de todos los objetos de una clase determinada solo cuando no se especifica CF_CONVERTONLY.

El comando convert, que invoca esta función, solo debe estar disponible para el usuario si OleUICanConvertOrActivateAs devuelve S_OK.

Nota

El encabezado oledlg.h define OLEUICONVERT 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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

Consulte también

OLEUICONVERT

OleUICanConvertOrActivateAs