Funzione OleGetAutoConvert (ole2.h)
Determina se il Registro di sistema è impostato per gli oggetti di un CLSID specificato da convertire automaticamente in un altro CLSID e, in caso affermativo, recupera il nuovo CLSID.
Sintassi
HRESULT OleGetAutoConvert(
[in] REFCLSID clsidOld,
[out] LPCLSID pClsidNew
);
Parametri
[in] clsidOld
CLSID per l'oggetto .
[out] pClsidNew
Puntatore a una variabile per ricevere il nuovo CLSID, se presente. Se la conversione automatica per clsidOld non è impostata nel Registro di sistema, clsidOld viene restituita. Il parametro pClsidNew non è mai NULL.
Valore restituito
Questa funzione può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Un valore è stato restituito correttamente tramite il parametro pclsidNew . |
|
CLSID non è registrato correttamente nel Registro di sistema. |
|
Errore di lettura dal Registro di sistema. |
|
La conversione automatica non è attiva o non è presente alcuna voce del Registro di sistema per il parametro clsidOld . |
Commenti
OleGetAutoConvert restituisce la voce AutoConvertTo nel Registro di sistema per l'oggetto specificato. La sottochiave AutoConvertTo specifica se gli oggetti di un CLSID specificato devono essere convertiti automaticamente in un nuovo CLSID. Questa operazione viene in genere usata per convertire i file creati dalle versioni precedenti di un'applicazione nella versione corrente. Se non è presente alcuna voce AutoConvertTo , questa funzione restituisce il valore di clsidOld.
La funzione OleDoAutoConvert chiama OleGetAutoConvert per determinare se l'oggetto specificato deve essere convertito. Un'applicazione contenitore che supporta la conversione dell'oggetto deve chiamare OleDoAutoConvert ogni volta che carica un oggetto. Se il contenitore usa la funzione helper OleLoad, non è necessario chiamare oleDoAutoConvert in modo esplicito perché OleLoad lo chiama internamente.
Per configurare la conversione automatica di una determinata classe, è possibile chiamare la funzione OleSetAutoConvert (in genere nel programma di installazione di un'applicazione). Questa funzione usa la sottochiave AutoConvertTo per contrassegnare una classe di oggetti per la conversione automatica in una classe diversa di oggetti. Si tratta di una sottochiave della chiave CLSID.
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 | ole2.h |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |
| Set di API | ext-ms-win-com-ole32-l1-1-0 (introdotta in Windows 8) |