System.Classes.TStreamAdapter.Stat

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Stat(out statstg: TStatStg; grfStatFlag: DWORD): HResult; virtual; stdcall;

C++

virtual HRESULT __stdcall Stat(/* out */ tagSTATSTG &statstg, unsigned grfStatFlag);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStreamAdapter


Beschreibung

Implementiert die IStream-Methode Stat.

Stat füllt einen TStatStg-Record mit Informationen über das Stream-Objekt. Der Parameter grfStatFlag gibt an, welche Informationen im Record, wenn überhaupt, benötigt werden.

TStatStg ist ein Alias für System.Types.tagSTATSTG. Der Record tagSTATSTG hat folgende Struktur:


  tagSTATSTG = record
    pwcsName: POleStr;
    dwType: FixedInt;
    cbSize: Largeint;
    mtime: TFileTime;
    ctime: TFileTime;
    atime: TFileTime;
    grfMode: FixedInt;
    grfLocksSupported: FixedInt;
    clsid: TCLSID;
    grfStateBits: FixedInt;
    reserved: FixedInt;
  end;

Stat ignoriert den Parameter grfStatFlag. Die Funktion setzt dwType immer auf STGTY_STREAM, grfLocksSupported auf LOCK_WRITE und alle TFileTime-Parameter auf 0. cbSize wird auf die Größe des Streams gesetzt, und die übrigen Felder bleiben unverändert.

TFileTime ist ein Alias für den Record System.Types._FILETIME, der folgende Struktur hat:


  _FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

Stat gibt S_OK zurück, wenn keine Exceptions beim Füllen von statstg auftreten, ansonsten wird E_UNEXPECTED zurückgegeben.

Siehe auch