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 |