Condividi tramite

Funzione OleUIBusyA (oledlg.h)

  • Articolo

Richiama la finestra di dialogo standard occupato, consentendo all'utente di gestire la concorrenza.

Sintassi

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore a una struttura OLEUIBUSY che contiene informazioni utilizzate per inizializzare la finestra di dialogo.

Valore restituito

Questa funzione restituisce i valori seguenti:

Definizioni di esito positivo/errore standard

Codice restituito Descrizione
OLEUI_FALSE
 Errore sconosciuto (inutilizzato).
OLEUI_SUCCESS
 Nessun errore, uguale a OLEUI_OK.
OLEUI_OK
 L'utente ha premuto il pulsante OK.
OLEUI_CANCEL
 L'utente ha premuto il pulsante annulla e che il chiamante deve annullare l'operazione.
OLEUI_BZ_SWITCHTOSELECTED
 L'utente ha premuto Passa a e OleUIBusy non è riuscito a determinare come passare all'applicazione di blocco. In questo caso, il chiamante deve adottare misure per tentare di risolvere il conflitto stesso, se possibile o ripetere l'operazione. OleUIBusy restituirà solo OLEUI_BZ_SWITCHTOSELECTED se l'utente ha premuto il pulsante , NULL e viene impostato il flag BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED
 L'utente ha premuto Passa a e OleUIBusy non è riuscito a determinare come passare all'applicazione di blocco. In questo caso, il chiamante deve adottare misure per tentare di risolvere il conflitto stesso, se possibile o ripetere l'operazione. OleUIBusy restituirà solo OLEUI_BZ_SWITCHTOSELECTED se l'utente ha premuto il pulsante , NULL e viene impostato il flag BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED
 L'utente ha premuto Passa a e OleUIBusy non è riuscito a determinare come passare all'applicazione di blocco. In questo caso, il chiamante deve adottare misure per tentare di risolvere il conflitto stesso, se possibile o ripetere l'operazione. OleUIBusy restituirà solo OLEUI_BZ_SWITCHTOSELECTED se l'utente ha premuto il pulsante , NULL e viene impostato il flag BZ_NOTRESPONDING.
OLEUI_BZ_RETRYSELECTED
L'utente ha premuto il pulsante Riprova o ha tentato di risolvere il conflitto (probabilmente passando all'applicazione di blocco). In questo caso, il chiamante deve ripetere l'operazione.
OLEUI_BZ_CALLUNBLOCKED
La finestra di dialogo è stata informata che l'operazione non è più bloccata.
 

Errori di convalida dei campi standard

Codice restituito Descrizione
OLEUI_ERR_STANDARDMIN
 Gli errori comuni a tutte le finestre di dialogo si trovano nell'intervallo OLEUI_ERR_STANDARDMIN da OLEUI_ERR_STANDARDMAX. Questo valore consente all'applicazione di testare i messaggi standard per visualizzare i messaggi di errore all'utente.
OLEUI_ERR_STRUCTURENULL
 Il puntatore a una struttura OLEUIXXX passata alla funzione è stato NULL.
OLEUI_ERR_STRUCTUREINVALID
 Autorizzazioni insufficienti per l'accesso in lettura o scrittura a una struttura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
Il valore cbstruct non è corretto.
OLEUI_ERR_HWNDOWNERINVALID
 Il valore hWndOwner non è valido.
OLEUI_ERR_LPSZCAPTIONINVALID
 Il valore lpszCaption non è valido.
OLEUI_ERR_LPFNHOOKINVALID
 Il valore lpfnHook non è valido.
OLEUI_ERR_HINSTANCEINVALID
 Il valore hInstance non è valido.
OLEUI_ERR_LPSZTEMPLATEINVALID
 Il valore lpszTemplate non è valido.
OLEUI_ERR_HRESOURCEINVALID
 Il valore hResource non è valido.
 

Errori di inizializzazione

Codice restituito Descrizione
OLEUI_ERR_FINDTEMPLATEFAILURE
 Impossibile trovare il modello della finestra di dialogo.
OLEUI_ERR_LOADTEMPLATEFAILURE
 Impossibile caricare il modello della finestra di dialogo.
OLEUI_ERR_DIALOGFAILURE
 Inizializzazione della finestra di dialogo non riuscita.
OLEUI_ERR_LOCALMEMALLOC
 Chiamata a LocalAlloc o allocatore IMalloc standard .
OLEUI_ERR_GLOBALMEMALLOC
 Chiamata a GlobalAlloc o allocatore IMalloc standard .
OLEUI_ERR_LOADSTRING
 Impossibile chiamare LoadString per le risorse localizzate dalla libreria.
OLEUI_ERR_OLEMEMALLOC
 Una chiamata allocatore standard IMalloc non è riuscita.
 

Errori specifici della funzione

Codice restituito Descrizione
OLEUI_ERR_STANDARDMAX
 Gli errori comuni a tutte le finestre di dialogo si trovano nell'intervallo OLEUI_ERR_STANDARDMIN da OLEUI_ERR_STANDARDMAX. Questo valore consente all'applicazione di testare i messaggi standard per visualizzare i messaggi di errore all'utente.
OLEUI_BZERR_HTASKINVALID
 HTask specificato nel membro hTask della struttura OLEUIBUSY non è valida.

Osservazioni

La finestra di dialogo OLE Server standard Occupato notifica all'utente che l'applicazione server non riceve messaggi. La finestra di dialogo chiede quindi all'utente di annullare l'operazione, passare all'attività bloccata o continuare ad attendere.

Nota

L'intestazione oledlg.h definisce OLEUIBUSY come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione oledlg.h
libreria OleDlg.lib
dll OleDlg.dll

Vedere anche

OLEUIBUSY