System.Classes.TStreamAdapter.Stat

• 親: TStreamAdapter

Delphi

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

C++

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

プロパティ

種類	可視性	ソース	ユニット	親
function	public	System.Classes.pas System.Classes.hpp	System.Classes	TStreamAdapter

説明

IStream の Stat メソッドの実装です。

Stat は、ストリーム オブジェクトに関する情報を TStatStg レコードに書き込みます。grfStatFlag パラメータは、レコード内に不要な情報がある場合にそれを示します。

TStatStg は System.Types.tagSTATSTG のエイリアスです。tagSTATSTG レコードは次のようなものです。

  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 では grfStatFlag パラメータを無視します。dwType は STGTY_STREAM に、grfLocksSupported は LOCK_WRITE に、すべての TFileTime パラメータは 0 に、常に設定されます。cbSize はストリームのサイズに設定され、残りのフィールドは変更されません。

TFileTime は System.Types._FILETIME のエイリアスで、次のようなものです。

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

Stat は、statstg の設定時に例外が発生しなければ S_OK を、そうでなければ E_UNEXPECTED を返します。

関連項目

• Size

• Stream