WriteFmtUserTypeStg-Funktion (ole2.h)
Die WriteFmtUserTypeStg-Funktion schreibt ein Zwischenablageformat und einen Benutzertyp in das Speicherobjekt.
Syntax
HRESULT WriteFmtUserTypeStg(
[in] LPSTORAGE pstg,
[in] CLIPFORMAT cf,
[in] LPOLESTR lpszUserType
);
Parameter
[in] pstg
IStorage-Zeiger auf das Speicherobjekt, in das die Informationen geschrieben werden sollen.
[in] cf
Gibt das Format der Zwischenablage an, das die Struktur des systemeigenen Bereichs des Speicherobjekts beschreibt. Das Formattag enthält die Richtlinie für die Namen von Streams und Unterspeichern innerhalb dieses Speicherobjekts sowie die Regeln für die Interpretation von Daten innerhalb dieser Datenströme.
[in] lpszUserType
Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den aktuellen Benutzertyp des Objekts angibt. Der Benutzertypwert selbst kann nicht NULL sein. Dies ist der Typ, der von der IOleObject::GetUserType-Methode zurückgegeben wird. Wenn diese Funktion auf einen Remotecomputer übertragen wird, auf dem die Objektklasse nicht vorhanden ist, kann dieser dauerhaft gespeicherte Benutzertyp dem Benutzer in Dialogfeldern angezeigt werden.
Rückgabewert
Diese Funktion gibt HRESULT zurück.
Hinweise
Die WriteFmtUserTypeStg-Funktion muss in der Implementierung eines Objekts der IPersistStorage::Save-Methode aufgerufen werden. Sie muss auch von Objekten auf Dokumentebene aufgerufen werden, die strukturierten Speicher für ihre persistente Darstellung in ihrer Speichersequenz verwenden.
Um die gespeicherten Informationen zu lesen, rufen Anwendungen die ReadFmtUserTypeStg-Funktion auf.
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-3 (eingeführt in Windows 10, Version 10.0.10240) |