Função OleUIBusyA (oledlg.h)

  • Artigo

Invoca a caixa de diálogo Ocupado padrão, permitindo que o usuário gerencie a simultaneidade.

Sintaxe

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Parâmetros

[in] unnamedParam1

Ponteiro para uma estrutura OLEUIBUSY que contém informações usadas para inicializar a caixa de diálogo.

Retornar valor

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 o OleUIBusy não pôde determinar como alternar para o aplicativo de bloqueio. Nesse caso, o chamador deve tomar medidas para tentar resolve 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 for NULL e o sinalizador BZ_NOTRESPONDING estiver definido.
OLEUI_BZ_SWITCHTOSELECTED
 O usuário pressionou Alternar para e o OleUIBusy não pôde determinar como alternar para o aplicativo de bloqueio. Nesse caso, o chamador deve tomar medidas para tentar resolve 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 for NULL e o sinalizador BZ_NOTRESPONDING estiver definido.
OLEUI_BZ_SWITCHTOSELECTED
 O usuário pressionou Alternar para e o OleUIBusy não pôde determinar como alternar para o aplicativo de bloqueio. Nesse caso, o chamador deve tomar medidas para tentar resolve 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 for NULL e o sinalizador BZ_NOTRESPONDING estiver definido.
OLEUI_BZ_RETRYSELECTED
O usuário pressionou o botão Repetir ou tentou resolve 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 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 os recursos localizados da biblioteca.
OLEUI_ERR_OLEMEMALLOC
 Falha em uma chamada para 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_BZERR_HTASKINVALID
 O hTask especificado no membro hTask da estrutura OLEUIBUSY é inválido.

Comentários

A caixa de diálogo OLE Server Busy padrão notifica o usuário de que o aplicativo de 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.

Observação

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 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

Confira também

OLEUIBUSY