Compartilhar via

Função OleUIObjectPropertiesA (oledlg.h)

  • Artigo

Invoca a caixa de diálogo propriedades do objeto , que exibe informações Geral, Exibire Link sobre um objeto.

Sintaxe

UINT OleUIObjectPropertiesA(
  [in] LPOLEUIOBJECTPROPSA unnamedParam1
);

Parâmetros

[in] unnamedParam1

Ponteiro para a estrutura de OLEUIOBJECTPROPS .

Valor de retorno

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 foi NULL.
OLEUI_ERR_STRUCTUREINVALID
 Permissões insuficientes para acesso de leitura ou gravação a uma estrutura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
 O valor de 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 de hInstance é inválido.
OLEUI_ERR_LPSZTEMPLATEINVALID
 O valor lpszTemplate é inválido.
OLEUI_ERR_HRESOURCEINVALID
 O hResource valor é inválido.
 

Erros de inicialização

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
 Falha ao LocalAlloc ou ao alocador de IMalloc de padrão.
OLEUI_ERR_GLOBALMEMALLOC
 Falha ao GlobalAlloc ou ao alocador de IMalloc de padrão.
OLEUI_ERR_LOADSTRING
 Não é possível chamar LoadString para recursos localizados da biblioteca.
OLEUI_ERR_OLEMEMALLOC
 Falha ao chamar o alocador de IMalloc de 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, lpVPou 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, lpVPou 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 lpPS membro estão incorretas.
OLEUI_OPERR_INVALIDPAGES
 Algumas propriedades de subconsulta do lpPS membro estão incorretas.
OLEUI_OPERR_NOTSUPPORTED
 Uma propriedade de subconsulta do lpPS membro está incorreta.
OLEUI_OPERR_DLGPROCNOTNULL
 Uma propriedade de subconsulta do lpPS membro está incorreta.
OLEUI_OPERR_LPARAMNOTZERO
 Uma propriedade de subconsulta do lpPS membro 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 de 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.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho oledlg.h
biblioteca OleDlg.lib
de DLL OleDlg.dll

Consulte também

IOleUILinkInfo

IOleUIObjInfo

OLEUIGNRLPROPS

OLEUILINKPROPS

OLEUIOBJECTPROPS

OLEUIVIEWPROPS