System.Classes.TStreamAdapter.Stat

• Aller au parent : TStreamAdapter

Delphi

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

C++

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

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.Classes.pas System.Classes.hpp	System.Classes	TStreamAdapter

Description

Implémente la méthode Stat de IStream.

Stat renseigne un enregistrement TStatStg avec les informations sur l'objet flux. Le paramètre grfStatFlag indique quelles informations de l'enregistrement ne sont, le cas échéant, pas nécessaires.

TStatStg est un alias pour System.Types.tagSTATSTG. L'enregistrement tagSTATSTG ressemble à :

  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 ignore le paramètre grfStatFlag. Elle définit toujours dwType par STGTY_STREAM, grfLocksSupported par LOCK_WRITE et tous les paramètres TFileTime par 0. Elle définit cbSize par la taille du flux et laisse inchangés les champs restants.

TFileTime est un alias pour System.Types._FILETIME, qui ressemble à :

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

Stat renvoie S_OK si elle ne rencontre aucune exception en remplissant statstg. Elle renvoie E_UNEXPECTED dans le cas contraire.

Voir aussi

• Size

• Stream