Função OleUIObjectPropertiesW (oledlg.h)

Artigo
08/25/2023

Invoca a caixa de diálogo Propriedades do Objeto , que exibe informações gerais, de exibição e de link sobre um objeto.

Sintaxe

UINT OleUIObjectPropertiesW(
  [in] LPOLEUIOBJECTPROPSW unnamedParam1
);

Parâmetros

[in] unnamedParam1

Ponteiro para a estrutura OLEUIOBJECTPROPS .

Retornar valor

Definições padrão de êxito/erro

Código de retorno	Descrição
OLEUI_FALSE	Falha desconhecida (não utilizado).
OLEUI_OK	O usuário pressionou o botão OK .
OLEUI_SUCCESS	Nenhum erro, o mesmo que OLEUI_OK.
OLEUI_CANCEL	O usuário pressionou o botão Cancelar .

Erros de validação de campo padrão

Código de retorno	Descrição
OLEUI_ERR_STANDARDMIN	Erros comuns a todas as caixas de diálogo estão no intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Esse valor permite que o aplicativo teste mensagens padrão para exibir mensagens de erro para o usuário.
OLEUI_ERR_STRUCTURENULL	O ponteiro para uma estrutura OLEUIXXX passada para a função era NULL.
OLEUI_ERR_STRUCTUREINVALID	Permissões insuficientes para acesso de leitura ou gravação a uma estrutura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	O valor de cbstruct está incorreto.
OLEUI_ERR_HWNDOWNERINVALID	O valor hWndOwner é inválido.
OLEUI_ERR_LPSZCAPTIONINVALID	O valor lpszCaption é inválido.
OLEUI_ERR_LPFNHOOKINVALID	O valor lpfnHook é inválido.
OLEUI_ERR_HINSTANCEINVALID	O valor hInstance é inválido.
OLEUI_ERR_LPSZTEMPLATEINVALID	O valor lpszTemplate é inválido.
OLEUI_ERR_HRESOURCEINVALID	O valor hResource é inválido.

Erros de inicialização

Código de retorno	Descrição
OLEUI_ERR_FINDTEMPLATEFAILURE	Não é possível localizar o modelo da caixa de diálogo.
OLEUI_ERR_LOADTEMPLATEFAILURE	Não é possível carregar o modelo da caixa de diálogo.
OLEUI_ERR_DIALOGFAILURE	Falha na inicialização da caixa de diálogo.
OLEUI_ERR_LOCALMEMALLOC	Uma chamada para LocalAlloc ou o alocador IMalloc padrão falhou.
OLEUI_ERR_GLOBALMEMALLOC	Uma chamada para GlobalAlloc ou o alocador IMalloc padrão falhou.
OLEUI_ERR_LOADSTRING	Não é possível chamar LoadString para recursos localizados da biblioteca.
OLEUI_ERR_OLEMEMALLOC	Falha ao chamar o alocador IMalloc padrão.

Erros específicos da função

Código de retorno	Descrição
OLEUI_ERR_STANDARDMAX	Erros comuns a todas as caixas de diálogo estão no intervalo OLEUI_ERR_STANDARDMIN a OLEUI_ERR_STANDARDMAX. Esse valor permite que o aplicativo teste mensagens padrão para exibir mensagens de erro para o usuário.
OLEUI_OPERR_SUBPROPNULL	lpGP ou lpVP é NULL, ou dwFlags e OPF_OBJECTISLINK e lpLP são NULL.
OLEUI_OPERR_SUBPROPINVALID	Permissões de acesso de gravação insuficientes para as estruturas apontadas por lpGP, lpVP ou lpLP.
OLEUI_OPERR_PROPSHEETNULL	O valor lpLP é NULL.
OLEUI_OPERR_PROPSHEETINVALID	Permissões de acesso de gravação insuficientes para as estruturas apontadas por lpGP, lpVP ou lpLP.
OLEUI_OPERR_SUPPROP	O ponteiro da propriedade sub-link, lpLP, é NULL.
OLEUI_OPERR_PROPSINVALID	Acesso de gravação insuficiente para o ponteiro da propriedade sub-link, lpLP.
OLEUI_OPERR_PAGESINCORRECT	Algumas propriedades de subconsulta do membro lpPS estão incorretas.
OLEUI_OPERR_INVALIDPAGES	Algumas propriedades de subconsulta do membro lpPS estão incorretas.
OLEUI_OPERR_NOTSUPPORTED	Uma propriedade de sub-link do membro lpPS está incorreta.
OLEUI_OPERR_DLGPROCNOTNULL	Uma propriedade de sub-link do membro lpPS está incorreta.
OLEUI_OPERR_LPARAMNOTZERO	Uma propriedade de sub-link do membro lpPS está incorreta.
OLEUI_GPERR_STRINGINVALID	Um valor de cadeia de caracteres (por exemplo, lplpszLabel ou lplpszType) é inválido.
OLEUI_GPERR_CLASSIDINVALID	O valor clsid é inválido.
OLEUI_GPERR_LPCLSIDEXCLUDEINVALID	O valor ClsidExcluded é inválido.
OLEUI_GPERR_CBFORMATINVALID	O valor wFormat é inválido.
OLEUI_VPERR_METAPICTINVALID	O valor hMetaPict é inválido.
OLEUI_VPERR_DVASPECTINVALID	O valor dvAspect é inválido.
OLEUI_OPERR_PROPERTYSHEET	O valor lpPS está incorreto.
OLEUI_OPERR_OBJINFOINVALID	O valor lpObjInfo é NULL ou o processo de chamada não tem acesso de leitura.
OLEUI_OPERR_LINKINFOINVALID	O valor lpLinkInfo é NULL ou o processo de chamada não tem acesso de leitura.

Comentários

OleUIObjectProperties é passada uma estrutura OLEUIOBJECTPROPS , que fornece as informações necessárias para preencher as guias Geral, Exibição e Link da caixa de diálogo Propriedades do Objeto .

Observação

O cabeçalho oledlg.h define OleUIObjectProperties como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oledlg.h
Biblioteca	OleDlg.lib
DLL	OleDlg.dll