Funzione OleUIBusyA (oledlg.h)
Richiama la finestra di dialogo Occupato standard, consentendo all'utente di gestire la concorrenza.
Sintassi
UINT OleUIBusyA(
[in] LPOLEUIBUSYA unnamedParam1
);
Parametri
[in] unnamedParam1
Puntatore a una struttura OLEUIBUSY che contiene informazioni usate per inizializzare la finestra di dialogo.
Valore restituito
Questa funzione restituisce i valori seguenti:
Definizioni di errori/esito positivo standard
| Codice restituito | Descrizione |
|---|---|
|
Errore sconosciuto (inutilizzato). |
|
Nessun errore, uguale a OLEUI_OK. |
|
L'utente ha premuto il pulsante OK . |
|
L'utente ha premuto il pulsante Annulla e che il chiamante deve annullare l'operazione. |
|
L'utente ha premuto Switch To 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 riprovare l'operazione. OleUIBusy restituirà OLEUI_BZ_SWITCHTOSELECTED solo se l'utente ha premuto il pulsante Switch To , hTask è NULL e il flag di BZ_NOTRESPONDING è impostato. |
|
L'utente ha premuto Switch To 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 riprovare l'operazione. OleUIBusy restituirà OLEUI_BZ_SWITCHTOSELECTED solo se l'utente ha premuto il pulsante Switch To , hTask è NULL e il flag di BZ_NOTRESPONDING è impostato. |
|
L'utente ha premuto Switch To 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 riprovare l'operazione. OleUIBusy restituirà OLEUI_BZ_SWITCHTOSELECTED solo se l'utente ha premuto il pulsante Switch To , hTask è NULL e il flag di BZ_NOTRESPONDING è impostato. |
|
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. |
|
La finestra di dialogo è stata informata che l'operazione non è più bloccata. |
Errori di convalida dei campi standard
| Codice restituito | Descrizione |
|---|---|
|
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. |
|
Il puntatore a una struttura OLEUIXXX passata alla funzione era NULL. |
|
Autorizzazioni insufficienti per l'accesso in lettura o scrittura a una struttura OLEUIXXX. |
|
Il valore cbstruct non è corretto. |
|
Il valore hWndOwner non è valido. |
|
Il valore lpszCaption non è valido. |
|
Il valore lpfnHook non è valido. |
|
Il valore hInstance non è valido. |
|
Il valore lpszTemplate non è valido. |
|
Il valore hResource non è valido. |
Errori di inizializzazione
| Codice restituito | Descrizione |
|---|---|
|
Impossibile trovare il modello della finestra di dialogo. |
|
Impossibile caricare il modello della finestra di dialogo. |
|
Impossibile inizializzare la finestra di dialogo. |
|
Una chiamata a LocalAlloc o all'allocatore IMalloc standard non è riuscita. |
|
Una chiamata a GlobalAlloc o all'allocatore IMalloc standard non è riuscita. |
|
Impossibile chiamare LoadString per le risorse localizzate dalla libreria. |
|
Una chiamata all'allocatore IMalloc standard non è riuscita. |
Errori specifici della funzione
| Codice restituito | Descrizione |
|---|---|
|
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. |
|
HTask specificato nel membro hTask della struttura OLEUIBUSY non è valido. |
Commenti
La finestra di dialogo OLE Server Occupato standard 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 in attesa.
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | oledlg.h |
| Libreria | OleDlg.lib |
| DLL | OleDlg.dll |