Funzione GetConvertStg (coml2api.h)

La funzione GetConvertStg restituisce il valore corrente del bit di conversione per l'oggetto di archiviazione specificato.

Sintassi

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

Parametri

[in] pStg

Puntatore IStorage all'oggetto di archiviazione da cui recuperare il bit di conversione.

Valore restituito

Errori di accesso allo spazio di archiviazione iStorage::OpenStorage::OpenStorage e ISequentialStream::Read.

Commenti

La funzione GetConvertStg viene chiamata dai server oggetti che supportano la conversione di un oggetto da un formato a un altro. Il server deve essere in grado di leggere l'oggetto di archiviazione usando il formato dell'identificatore di classe precedente (CLSID) e scrivere l'oggetto usando il formato del nuovo CLSID per supportare la conversione dell'oggetto. Ad esempio, un foglio di calcolo creato da un'applicazione può essere convertito nel formato usato da un'applicazione diversa.

Il bit di conversione viene impostato da una chiamata alla funzione SetConvertStg . Un'applicazione contenitore può chiamare questa funzione sulla richiesta di un utente finale oppure un programma di installazione può chiamarlo durante l'installazione di una nuova versione di un'applicazione. Un utente finale richiede la conversione di un oggetto tramite la finestra di dialogo Converti in . Quando un oggetto viene convertito, il nuovo CLSID viene assegnato in modo permanente all'oggetto, quindi l'oggetto viene successivamente associato al nuovo CLSID.

Quindi, quando l'oggetto viene attivato, il server chiama la funzione GetConvertStg per recuperare il valore del bit di conversione dall'oggetto di archiviazione. Se il bit è impostato, il CLSID dell'oggetto è stato modificato e il server deve leggere il formato precedente e scrivere il nuovo formato per l'oggetto di archiviazione.

Dopo aver recuperato il valore di bit, l'applicazione dell'oggetto deve cancellare il bit di conversione chiamando la funzione SetConvertStg con il relativo parametro fConvert impostato su FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	coml2api.h (include Ole2.h)
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

SetConvertStg