Funzione OleUIPromptUserW (oledlg.h)

  • Articolo

Visualizza una finestra di dialogo con il modello specificato e restituisce la risposta (identificatore del pulsante) dall'utente. Questa funzione viene usata per visualizzare i messaggi di avviso OLE, ad esempio Classe non registrata.

Sintassi

int OleUIPromptUserW(
  [in] int  nTemplate,
  [in] HWND hwndParent,
       ...  
);

Parametri

[in] nTemplate

Numero di risorse della finestra di dialogo da visualizzare. Vedere la sezione Osservazioni.

[in] hwndParent

Handle nella 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 essere sicuro di passare il numero e i tipi corretti di argomenti.

Valore restituito

Definizioni di errori/esito positivo standard

Codice restituito Descrizione
OLEUI_FALSE
 Errore sconosciuto (inutilizzato).
OLEUI_OK
 L'utente ha premuto il pulsante OK .
OLEUI_SUCCESS
 Nessun errore, uguale a OLEUI_OK.
OLEUI_CANCEL
 L'utente ha premuto il pulsante Annulla .
 

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 era 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
 Impossibile inizializzare la finestra di dialogo.
OLEUI_ERR_LOCALMEMALLOC
 Una chiamata a LocalAlloc o all'allocatore IMalloc standard non è riuscita.
OLEUI_ERR_GLOBALMEMALLOC
 Una chiamata a GlobalAlloc o all'allocatore IMalloc standard non è riuscita.
OLEUI_ERR_LOADSTRING
 Impossibile chiamare LoadString per le risorse localizzate dalla libreria.
OLEUI_ERR_OLEMEMALLOC
 Una chiamata all'allocatore IMalloc standard 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.

Commenti

I modelli di finestra di dialogo seguenti sono definiti in Linee guida per l'interfaccia di Windows-A per la progettazione di software. Il parametro nTemplate deve essere una risorsa attualmente definita, ma è possibile aggiungere modelli aggiuntivi 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 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