Share via

CoGetTreatAsClass-Funktion (combaseapi.h)

  • Artikel

Gibt die CLSID eines Objekts zurück, das das angegebene Objekt emulieren kann.

Syntax

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

Parameter

[in] clsidOld

Die CLSID des Objekts, das einem Objekt mit einer anderen CLSID emuliert (behandelt als) werden kann.

[out] pClsidNew

Ein Zeiger auf den Speicherort der CLSID, die clsidOld-Objekte emulieren kann. Dieser Parameter darf nicht NULL sein. Wenn keine Emulationsinformationen für clsidOld-Objekte vorhanden sind, wird der clsidOld-Parameter angegeben.

Rückgabewert

Diese Funktion kann die folgenden Werte sowie alle von der CLSIDFromString-Funktion zurückgegebenen Fehlerwerte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Eine neue CLSID wurde erfolgreich zurückgegeben.
S_FALSE
 Es gibt keine Emulationsinformationen für den clsidOld-Parameter , sodass der pClsidNew-Parameter auf clsidOld festgelegt ist.
REGDB_E_READREGDB
Fehler beim Lesen der Registrierung.

Hinweise

CoGetTreatAsClass gibt den TreatAs-Eintrag in der Registrierung für das angegebene Objekt zurück. Der TreatAs-Eintrag ist, sofern festgelegt, die CLSID eines registrierten Objekts (einer Anwendung), das das betreffende Objekt emulieren kann. Der TreatAs-Eintrag wird über einen Aufruf der CoTreatAsClass-Funktion festgelegt. Die Emulation ermöglicht es einer Anwendung, ein Objekt eines anderen Formats zu öffnen und zu bearbeiten, während das ursprüngliche Format des Objekts beibehalten wird. Objekte der ursprünglichen CLSID werden aktiviert und als Objekte der zweiten CLSID behandelt. Wenn das Objekt gespeichert wird, kann dies zum Verlust von Bearbeitungen führen, die vom ursprünglichen Format nicht unterstützt werden. Wenn kein TreatAs-Eintrag für das angegebene Objekt vorhanden ist, gibt diese Funktion die CLSID des ursprünglichen Objekts (clsidOld) zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile combaseapi.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

CoTreatAsClass