IStream::Stat メソッド (objidl.h)
Stat メソッドは、このストリームの STATSTG 構造体を取得します。
構文
HRESULT Stat(
[out] STATSTG *pstatstg,
[in] DWORD grfStatFlag
);
パラメーター
[out] pstatstg
このメソッドがこのストリーム オブジェクトに関する情報を配置する STATSTG 構造体へのポインター。
[in] grfStatFlag
このメソッドが STATSTG 構造体のメンバーの一部を返さないので、メモリ割り当て操作を保存することを指定します。 値は STATFLAG 列挙から取得されます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
S_OK | STATSTG 構造体は、指定した場所で正常に返されました。 |
E_PENDING | 非同期ストレージのみ: ストリームのデータの一部またはすべてが現在使用できません。 |
STG_E_ACCESSDENIED | 呼び出し元には、このストレージ オブジェクトの統計にアクセスするための十分なアクセス許可がありません。 |
STG_E_INSUFFICIENTMEMORY | メモリ不足のため、STATSTG 構造体が返されませんでした。 |
STG_E_INVALIDFLAG | grfStateFlag パラメーターの値が無効です。 |
STG_E_INVALIDPOINTER | pStatStg ポインターが無効です。 |
STG_E_REVERTED | オブジェクトは、トランザクション ツリー内のオブジェクトの上にある元に戻す操作によって無効になっています。 |
注釈
IStream::Stat は、この開いているストリームに関する情報を含む STATSTG 構造体へのポインターを取得します。 このストリームが構造化ストレージ内にあり、 IStorage::EnumElements が呼び出されると、 IEnumSTATSTG インターフェイスを持つ列挙子オブジェクトが作成されます。これを呼び出して、それぞれに関連付けられている STATSTG 構造体を介してストレージとストリームを列挙できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | objidl.h |
Library | Uuid.lib |
[DLL] | Ole32.dll |