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 |
|---|---|
|
Ein Wert wurde erfolgreich über den Parameter pclsidNew zurückgegeben. |
|
Die CLSID ist nicht ordnungsgemäß in der Registrierung registriert. |
|
Fehler beim Lesen aus der Registrierung. |
|
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) |