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

Weitere Informationen

IPersistStorage::Save

ReadFmtUserTypeStg