IStream_Size-Funktion (shlwapi.h)

Ruft die Größe eines angegebenen Datenstroms in Bytes ab.

Syntax

LWSTDAPI IStream_Size(
  [in]  IStream        *pstm,
  [out] ULARGE_INTEGER *pui
);

Parameter

[in] pstm

Typ: IStream*

Ein Zeiger auf die IStream-Schnittstelle des Datenstroms, dessen Größe bestimmt werden soll.

[out] pui

Typ: ULARGE_INTEGER*

Ein Zeiger auf eine ULARGE_INTEGER-Struktur , um die Größe des Datenstroms zu empfangen.

Rückgabewert

Typ: HRESULT

Gibt S_OK bei Erfolg oder andernfalls einen COM-Fehlercode zurück. Weitere Informationen zu möglichen Fehlercodes finden Sie unter IStream::Stat .

Hinweise

Diese Funktion ruft die Größe des Datenstroms ab, indem die IStream::Stat-Methode des angegebenen Streamobjekts aufgerufen wird. Anschließend wird der Wert des cbSize-Members der STATSTG-Struktur kopiert, die von IStream::Stat zurückgegeben wird, in die ULARGE_INTEGER Struktur, auf die von pui verwiesen wird. Wenn die Funktion fehlschlägt, ist der Inhalt der ULARGE_INTEGER-Struktur undefiniert.

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)