Ponteiro para uma estrutura de OLEUIBUSY que contém informações usadas para inicializar a caixa de diálogo.
Valor de retorno
Essa função retorna os seguintes valores:
Definições padrão de êxito/erro
Código de retorno
Descrição
OLEUI_FALSE
Falha desconhecida (não utilizado).
OLEUI_SUCCESS
Nenhum erro, o mesmo que OLEUI_OK.
OLEUI_OK
O usuário pressionou o botão OK.
OLEUI_CANCEL
O usuário pressionou o botão Cancelar e que o chamador deve cancelar a operação.
OLEUI_BZ_SWITCHTOSELECTED
O usuário pressionou Alternar para e OleUIBusy não pôde determinar como alternar para o aplicativo de bloqueio. Nesse caso, o chamador deve tomar medidas para tentar resolver o conflito em si, se possível, ou repetir a operação.
OleUIBusy só retornará OLEUI_BZ_SWITCHTOSELECTED se o usuário tiver pressionado o botão Alternar para, hTask estiver NULL e o sinalizador BZ_NOTRESPONDING estiver definido.
OLEUI_BZ_SWITCHTOSELECTED
O usuário pressionou Alternar para e OleUIBusy não pôde determinar como alternar para o aplicativo de bloqueio. Nesse caso, o chamador deve tomar medidas para tentar resolver o conflito em si, se possível, ou repetir a operação.
OleUIBusy só retornará OLEUI_BZ_SWITCHTOSELECTED se o usuário tiver pressionado o botão Alternar para, hTask estiver NULL e o sinalizador BZ_NOTRESPONDING estiver definido.
OLEUI_BZ_SWITCHTOSELECTED
O usuário pressionou Alternar para e OleUIBusy não pôde determinar como alternar para o aplicativo de bloqueio. Nesse caso, o chamador deve tomar medidas para tentar resolver o conflito em si, se possível, ou repetir a operação.
OleUIBusy só retornará OLEUI_BZ_SWITCHTOSELECTED se o usuário tiver pressionado o botão Alternar para, hTask estiver NULL e o sinalizador BZ_NOTRESPONDING estiver definido.
OLEUI_BZ_RETRYSELECTED
O usuário pressionou o botão Repetir ou tentou resolver o conflito (provavelmente alternando para o aplicativo de bloqueio). Nesse caso, o chamador deve repetir a operação.
OLEUI_BZ_CALLUNBLOCKED
A caixa de diálogo foi informada de que a operação não está mais bloqueada.
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
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 os 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_BZERR_HTASKINVALID
O hTask especificado no hTask membro da estrutura de OLEUIBUSY é inválido.
Observações
A caixa de diálogo OLE Server Busy padrão notifica o usuário de que o aplicativo do servidor não está recebendo mensagens. Em seguida, a caixa de diálogo solicita que o usuário cancele a operação, alterne para a tarefa bloqueada ou continue aguardando.
Nota
O cabeçalho oledlg.h define OLEUIBUSY 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]