CoGetTreatAsClass-Funktion (combaseapi.h)
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 |
|---|---|
|
Eine neue CLSID wurde erfolgreich zurückgegeben. |
|
Es gibt keine Emulationsinformationen für den clsidOld-Parameter , sodass der pClsidNew-Parameter auf clsidOld festgelegt ist. |
|
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 |