Funzione OleUIConvertA (oledlg.h)
Richiama la finestra di dialogo Converti standard, consentendo all'utente di modificare il tipo di un singolo oggetto specificato o il tipo di tutti gli oggetti OLE della classe dell'oggetto specificato.
Sintassi
UINT OleUIConvertA(
[in] LPOLEUICONVERTA unnamedParam1
);
Parametri
[in] unnamedParam1
Puntatore a una struttura OLEUICONVERT contenente informazioni utilizzate per inizializzare la finestra di dialogo.
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. |
|
Valore clsid non valido. |
|
Valore dvAspect non valido. Questo membro specifica l'aspetto dell'oggetto . |
|
Valore wFormat non valido. Questo membro specifica il formato dati dell'oggetto. |
|
Valore stringa (ad esempio lpszUserType o lpszDefLabel) non valido. |
Commenti
OleUIConvert popola la casella di riepilogo della finestra di dialogo Converti con classi oggetto attraversando il Registro di sistema e cercando le voci nelle chiavi leggibili e scrivibili. Ogni classe che include il formato di file predefinito della classe originale nella chiave leggibile viene aggiunta all'elenco Converti e ogni classe che include il formato di file predefinito della classe originale nella chiave ReadWritable viene aggiunto all'elenco Attiva come. L'elenco Converti viene visualizzato nella casella di riepilogo della finestra di dialogo quando viene selezionato il pulsante di opzione Converti (selezione predefinita) e l'elenco Attiva come viene visualizzato quando si seleziona Attiva come .
Si noti che è possibile modificare il tipo di tutti gli oggetti di una determinata classe solo quando CF_CONVERTONLY non è specificato.
Il comando convert, che richiama questa funzione, deve essere reso disponibile all'utente solo se OleUICanConvertOrActivateAs restituisce S_OK.
Nota
L'intestazione oledlg.h definisce OLEUICONVERT 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 |