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
S_OK	Un valore è stato restituito correttamente tramite il parametro pclsidNew .
REGDB_E_CLASSNOTREG	CLSID non è registrato correttamente nel Registro di sistema.
REGDB_E_READREGDB	Errore di lettura dal Registro di sistema.
REGDB_E_KEYMISSING	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)

Vedi anche

AutoConvertTo

OleDoAutoConvert

OleSetAutoConvert