Función OleUIObjectPropertiesA (oledlg.h)

Artículo
03/01/2024

Invoca el cuadro de diálogo Propiedades del objeto , que muestra información general, vista y vínculo sobre un objeto.

Sintaxis

UINT OleUIObjectPropertiesA(
  [in] LPOLEUIOBJECTPROPSA unnamedParam1
);

Parámetros

[in] unnamedParam1

Puntero a la estructura OLEUIOBJECTPROPS .

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 presionó 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 de 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 en una llamada a LocalAlloc o al asignador IMalloc estándar.
OLEUI_ERR_GLOBALMEMALLOC	Error en una llamada 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 en una llamada 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_OPERR_SUBPROPNULL	lpGP o lpVP es NULL, o dwFlags y OPF_OBJECTISLINK y lpLP son NULL.
OLEUI_OPERR_SUBPROPINVALID	Permisos de acceso de escritura insuficientes para las estructuras a las que apunta lpGP, lpVP o lpLP.
OLEUI_OPERR_PROPSHEETNULL	El valor lpLP es NULL.
OLEUI_OPERR_PROPSHEETINVALID	Permisos de acceso de escritura insuficientes para las estructuras a las que apunta lpGP, lpVP o lpLP.
OLEUI_OPERR_SUPPROP	El puntero de la propiedad de sub link, lpLP, es NULL.
OLEUI_OPERR_PROPSINVALID	Acceso de escritura insuficiente para el puntero de propiedad de sub link, lpLP.
OLEUI_OPERR_PAGESINCORRECT	Algunas propiedades de sub link del miembro lpPS son incorrectas.
OLEUI_OPERR_INVALIDPAGES	Algunas propiedades de sub link del miembro lpPS son incorrectas.
OLEUI_OPERR_NOTSUPPORTED	Una propiedad de sub link del miembro lpPS es incorrecta.
OLEUI_OPERR_DLGPROCNOTNULL	Una propiedad de sub link del miembro lpPS es incorrecta.
OLEUI_OPERR_LPARAMNOTZERO	Una propiedad de sub link del miembro lpPS es incorrecta.
OLEUI_GPERR_STRINGINVALID	Un valor de cadena (por ejemplo, lplpszLabel o lplpszType) no es válido.
OLEUI_GPERR_CLASSIDINVALID	El valor clsid no es válido.
OLEUI_GPERR_LPCLSIDEXCLUDEINVALID	El valor ClsidExcluded no es válido.
OLEUI_GPERR_CBFORMATINVALID	El valor wFormat no es válido.
OLEUI_VPERR_METAPICTINVALID	El valor hMetaPict no es válido.
OLEUI_VPERR_DVASPECTINVALID	El valor dvAspect no es válido.
OLEUI_OPERR_PROPERTYSHEET	El valor lpPS es incorrecto.
OLEUI_OPERR_OBJINFOINVALID	El valor lpObjInfo es NULL o el proceso de llamada no tiene acceso de lectura.
OLEUI_OPERR_LINKINFOINVALID	El valor lpLinkInfo es NULL o el proceso de llamada no tiene acceso de lectura.

Comentarios

OleUIObjectProperties se pasa una estructura OLEUIOBJECTPROPS , que proporciona la información necesaria para rellenar las pestañas General, Vista y Vínculo del cuadro de diálogo Propiedades del objeto .

Nota

El encabezado oledlg.h define OleUIObjectProperties 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