IStream_Stat

Stat メソッドは、このストリームの STATSTG 構造体を取得する。

IStream_Stat this, pstatstg, grfStatFlag

this : [comobj] IStream インターフェースの COM オブジェクト変数
pstatstg : [var] このメソッドがこのストリームオブジェクトに関する情報を配置する STATSTG 構造体へのポインタ。
grfStatFlag : [int] このメソッドが STATSTG 構造体のメンバの一部を返さないように指定し、メモリ確保操作を節約する。値は STATFLAG 列挙から取得される。

(プラグイン / モジュール : com_misc.dll)

解説

Stat メソッドは、このストリームの STATSTG 構造体を取得する。

[戻り値]
このメソッドは次のいずれかの値を返す。 | リターンコード | 説明 |
|----------------|---------------| |S_OK | STATSTG
構造体が指定された位置に正常に返された。| |E_PENDING | 非同期ストレージのみ:
ストリームのデータの一部または全部が現在利用できない。 | |STG_E_ACCESSDENIED |
呼び出し側にこのストレージオブジェクトの統計情報にアクセスするための十分な権限がない。|
|STG_E_INSUFFICIENTMEMORY | メモリ不足のため STATSTG 構造体が返されなかった。|
|STG_E_INVALIDFLAG | *grfStateFlag* パラメータの値が有効でない。|
|STG_E_INVALIDPOINTER | *pStatStg* ポインタが有効でない。| |STG_E_REVERTED |
トランザクションツリーの上位の revert 操作によりオブジェクトが無効化された。|

[備考]
IStream::Stat は、この開いているストリームに関する情報を含む STATSTG
構造体へのポインタを取得する。このストリームが構造化ストレージ内にあり、IStorage::EnumElements
が呼び出されると、IEnumSTATSTG インターフェースを持つ列挙オブジェクトが作成され、それぞれに関連付けられた STATSTG
構造体を通じてストレージとストリームを列挙するために呼び出すことができる。

情報