IStream_Read-Funktion (shlwapi.h)

Liest Bytes aus einem angegebenen Stream und gibt einen Wert zurück, der angibt, ob alle Bytes erfolgreich gelesen wurden.

Syntax

LWSTDAPI IStream_Read(
  [in]  IStream *pstm,
  [out] void    *pv,
  [in]  ULONG   cb
);

Parameter

[in] pstm

Typ: IStream*

Ein Zeiger auf die IStream-Schnittstelle des Datenstroms, aus dem gelesen werden soll.

[out] pv

Typ: VOID*

Ein Zeiger auf einen Puffer, um die Datenstromdaten von pstm zu empfangen. Dieser Puffer muss mindestens cb Bytes groß sein.

[in] cb

Typ: ULONG

Die Anzahl der Datenbytes, die die Funktion aus dem Eingabedatenstrom lesen soll.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn die Funktion erfolgreich die angegebene Anzahl von Bytes aus dem Stream liest oder andernfalls einen COM-Fehlercode aufweist. Insbesondere wenn der Leseversuch erfolgreich war, aber weniger als cb Bytes gelesen wurden, gibt die Funktion E_FAIL zurück.

Hinweise

Diese Funktion ruft die ISequentialStream::Read-Methode auf, um Daten aus dem angegebenen Stream in den Puffer zu lesen. Wenn die Funktion aus irgendeinem Grund fehlschlägt, sind der Inhalt des Ausgabepuffers und die Position des Lesezeigers im Eingabedatenstrom nicht definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
DLL	Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

ISequentialStream::Read