ReadFmtUserTypeStg-Funktion (ole2.h)

Die ReadFmtUserTypeStg-Funktion gibt das Zwischenablageformat und den Benutzertyp zurück, der zuvor mit der WriteFmtUserTypeStg-Funktion gespeichert wurde.

Syntax

HRESULT ReadFmtUserTypeStg(
  [in]  LPSTORAGE  pstg,
  [out] CLIPFORMAT *pcf,
  [out] LPOLESTR   *lplpszUserType
);

Parameter

[in] pstg

Zeiger auf die IStorage-Schnittstelle für das Speicherobjekt, aus dem die Informationen gelesen werden sollen.

[out] pcf

Zeiger auf den Speicherort, an den das Zwischenablageformat bei der Rückgabe geschrieben werden soll. Es kann NULL sein, was angibt, dass das Format für den Aufrufer von keinem Interesse ist.

[out] lplpszUserType

Adresse der LPWSTR-Zeigervariable , die einen Zeiger auf die Zeichenfolge vom Unicode-Benutzertyp mit Null-Termin empfängt. Der Aufrufer kann NULL für diesen Parameter angeben, was angibt, dass der Benutzertyp von keinem Interesse ist. Diese Funktion ordnet Arbeitsspeicher für die Zeichenfolge zu. Der Aufrufer ist dafür verantwortlich, den Arbeitsspeicher mit CoTaskMemFree freizugeben.

Rückgabewert

Diese Funktion unterstützt zusätzlich zu folgendem die Standardrückgabewerte E_FAIL, E_INVALIDARG und E_OUTOFMEMORY:

Diese Funktion gibt auch alle Fehlerwerte zurück, die von der ISequentialStream::Read-Methode zurückgegeben werden.

Hinweise

ReadFmtUserTypeStg gibt das Zwischenablageformat und die Benutzertypzeichenfolge aus dem angegebenen Speicherobjekt zurück. Die WriteClassStg-Funktion muss vor dem Aufrufen der ReadFmtUserTypeStg-Funktion aufgerufen worden sein.

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

Weitere Informationen

CoTaskMemFree

WriteFmtUserTypeStg