Funzione CoGetTreatAsClass (combaseapi.h)

Articolo
02/24/2024

Restituisce il CLSID di un oggetto che può emulare l'oggetto specificato.

Sintassi

HRESULT CoGetTreatAsClass(
  [in]  REFCLSID clsidOld,
  [out] LPCLSID  pClsidNew
);

Parametri

[in] clsidOld

CLSID dell'oggetto che può essere emulato (considerato come) un oggetto con un CLSID diverso.

[out] pClsidNew

Puntatore al punto in cui viene recuperato il CLSID che può emulare gli oggetti clsidOld . Questo parametro non può essere NULL. Se non sono presenti informazioni di emulazione per gli oggetti clsidOld , viene fornito il parametro clsidOld .

Valore restituito

Questa funzione può restituire i valori seguenti, nonché tutti i valori di errore restituiti dalla funzione CLSIDFromString .

Codice restituito	Descrizione
S_OK	È stato restituito un nuovo CLSID.
S_FALSE	Non sono disponibili informazioni di emulazione per il parametro clsidOld , pertanto il parametro pClsidNew è impostato su clsidOld.
REGDB_E_READREGDB	Errore durante la lettura del Registro di sistema.

Commenti

CoGetTreatAsClass restituisce la voce TreatAs nel Registro di sistema per l'oggetto specificato. La voce TreatAs , se impostata, è il CLSID di un oggetto registrato (un'applicazione) in grado di emulare l'oggetto in questione. La voce TreatAs viene impostata tramite una chiamata alla funzione CoTreatAsClass . L'emulazione consente a un'applicazione di aprire e modificare un oggetto di un formato diverso, mantenendo il formato originale dell'oggetto. Gli oggetti del CLSID originale vengono attivati e trattati come oggetti del secondo CLSID. Quando l'oggetto viene salvato, ciò può comportare la perdita di modifiche non supportate dal formato originale. Se non è presente alcuna voce TreatAs per l'oggetto specificato, questa funzione restituisce il CLSID dell'oggetto originale (clsidOld).

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	combaseapi.h (include Objbase.h)
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

CoTreatAsClass

Condividi tramite