OleGetAutoConvert-Funktion (ole2.h)

Bestimmt, ob die Registrierung für Objekte einer angegebenen CLSID festgelegt ist, die automatisch in eine andere CLSID konvertiert werden sollen, und ruft die neue CLSID ab.

Syntax

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

Parameter

[in] clsidOld

Die CLSID für das -Objekt.

[out] pClsidNew

Ein Zeiger auf eine Variable, um die neue CLSID zu empfangen, falls vorhanden. Wenn die automatische Konvertierung für clsidOld in der Registrierung nicht festgelegt ist, wird clsidOld zurückgegeben. Der pClsidNew-Parameter ist nie NULL.

Rückgabewert

Diese Funktion kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Ein Wert wurde erfolgreich über den Parameter pclsidNew zurückgegeben.
REGDB_E_CLASSNOTREG	Die CLSID ist nicht ordnungsgemäß in der Registrierung registriert.
REGDB_E_READREGDB	Fehler beim Lesen aus der Registrierung.
REGDB_E_KEYMISSING	Die automatische Konvertierung ist nicht aktiv, oder es gab keinen Registrierungseintrag für den clsidOld-Parameter .

Hinweise

OleGetAutoConvert gibt den AutoConvertTo-Eintrag in der Registrierung für das angegebene Objekt zurück. Der Unterschlüssel AutoConvertTo gibt an, ob Objekte einer bestimmten CLSID automatisch in eine neue CLSID konvertiert werden sollen. Dies wird normalerweise verwendet, um Dateien, die von älteren Versionen einer Anwendung erstellt wurden, in die aktuelle Version zu konvertieren. Wenn kein AutoConvertTo-Eintrag vorhanden ist, gibt diese Funktion den Wert von clsidOld zurück.

Die OleDoAutoConvert-Funktion ruft OleGetAutoConvert auf, um zu bestimmen, ob das angegebene Objekt konvertiert werden soll. Eine Containeranwendung, die die Objektkonvertierung unterstützt, sollte oleDoAutoConvert jedes Mal aufrufen, wenn sie ein Objekt lädt. Wenn der Container die OleLoad-Hilfsfunktion verwendet, muss oleDoAutoConvert nicht explizit aufgerufen werden, da OleLoad ihn intern aufruft.

Zum Einrichten der automatischen Konvertierung einer bestimmten Klasse können Sie die OleSetAutoConvert-Funktion aufrufen (in der Regel im Setupprogramm einer Anwendungsinstallation). Diese Funktion verwendet den AutoConvertTo-Unterschlüssel , um eine Klasse von Objekten für die automatische Konvertierung in eine andere Klasse von Objekten zu taggen. Dies ist ein Unterschlüssel des CLSID-Schlüssels.

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	ole2.h
Bibliothek	Ole32.lib
DLL	Ole32.dll
APIs	ext-ms-win-com-ole32-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

AutoConvertTo

OleDoAutoConvert

OleSetAutoConvert