Funzione OleUIPromptUserA (oledlg.h)
Visualizza una finestra di dialogo con il modello specificato e restituisce la risposta (identificatore del pulsante) dell'utente. Questa funzione viene usata per visualizzare i messaggi di avviso OLE, ad esempio Classe non registrata.
Sintassi
int OleUIPromptUserA(
[in] int nTemplate,
[in] HWND hwndParent,
...
);
Parametri
[in] nTemplate
Numero di risorsa della finestra di dialogo da visualizzare. Vedere la sezione Osservazioni.
[in] hwndParent
Handle per la finestra padre della finestra di dialogo.
...
facoltativo. Titolo della finestra di dialogo seguito da un elenco di argomenti per la stringa di formato nel controllo statico (IDC_PU_TEXT) della finestra di dialogo. Il chiamante deve assicurarsi di passare il numero e i tipi di argomenti corretti.
Valore restituito
Definizioni di esito positivo/errore standard
| Codice restituito | Descrizione |
|---|---|
|
Errore sconosciuto (inutilizzato). |
|
L'utente ha premuto il pulsante OK . |
|
Nessun errore, come OLEUI_OK. |
|
L'utente ha premuto il pulsante Annulla . |
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 è 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. |
|
Inizializzazione della finestra di dialogo non riuscita. |
|
Chiamata a LocalAlloc o allocatore IMalloc standard non riuscita. |
|
Chiamata a GlobalAlloc o allocatore IMalloc standard non riuscita. |
|
Impossibile chiamare LoadString per le risorse localizzate dalla libreria. |
|
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. |
Commenti
I modelli di finestra di dialogo seguenti sono definiti in Linee guida per l'interfaccia Di Windows- Guida per la progettazione del software. Il parametro nTemplate deve essere una risorsa attualmente definita, ma è possibile aggiungere altri modelli a prompt.dlg.
IDD_LINKSOURCEUNAVAILABLE
IDD_CANNOTUPDATELINK
IDD_SERVERNOTREG
IDD_CANNOTRESPONDVERB
IDD_SERVERNOTFOUND
Nota
L'intestazione oledlg.h definisce OleUIPromptUser 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |