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 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IStream - 複合檔案實作

STATFLAG

STATSTG