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 |