GetConvertStg-Funktion (coml2api.h)

Die GetConvertStg-Funktion gibt den aktuellen Wert des Convert-Bits für das angegebene Speicherobjekt zurück.

Syntax

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

Parameter

[in] pStg

IStorage-Zeiger auf das Speicherobjekt, aus dem das Konvertierungsbit abgerufen werden soll.

Rückgabewert

IStorage::OpenStream, IStorage::OpenStorage und ISequentialStream::Read Storage- und Streamzugriffsfehler.

Hinweise

Die GetConvertStg-Funktion wird von Objektservern aufgerufen, die die Konvertierung eines Objekts von einem Format in ein anderes unterstützen. Der Server muss in der Lage sein, das Speicherobjekt im Format des vorherigen Klassenbezeichners (CLSID) zu lesen und das Objekt im Format seiner neuen CLSID zu schreiben, um die Konvertierung des Objekts zu unterstützen. Beispielsweise kann eine von einer Anwendung erstellte Kalkulationstabelle in das format konvertiert werden, das von einer anderen Anwendung verwendet wird.

Das Convert-Bit wird durch einen Aufruf der Funktion SetConvertStg festgelegt. Eine Containeranwendung kann diese Funktion auf Anforderung eines Endbenutzers aufrufen, oder ein Setupprogramm kann sie aufrufen, wenn eine neue Version einer Anwendung installiert wird. Ein Endbenutzer fordert die Konvertierung eines Objekts über das Dialogfeld Konvertieren in an. Wenn ein Objekt konvertiert wird, wird die neue CLSID dem Objekt dauerhaft zugewiesen, sodass das Objekt anschließend der neuen CLSID zugeordnet wird.

Wenn das Objekt aktiviert wird, ruft sein Server dann die GetConvertStg-Funktion auf, um den Wert des Convert-Bits aus dem Speicherobjekt abzurufen. Wenn das Bit festgelegt ist, wurde die CLSID des Objekts geändert, und der Server muss das alte Format lesen und das neue Format für das Speicherobjekt schreiben.

Nach dem Abrufen des Bitwerts sollte die Objektanwendung das Convert-Bit löschen, indem sie die SetConvertStg-Funktion aufruft , deren fConvert-Parameter auf FALSE festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	coml2api.h (ole2.h einschließen)
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

SetConvertStg