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 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.
|
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] |
| da Plataforma de Destino |
Windows |
| cabeçalho |
oledlg.h |
| biblioteca |
OleDlg.lib |
| de DLL |
OleDlg.dll |
Consulte também
OLEUIBUSY