IStorage：：Stat 方法 (objidl.h)

發行項
03/05/2024

Stat 方法會擷取這個開啟儲存物件的 STATSTG 結構。

語法

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

參數

[out] pstatstg

傳回時，指向 STATSTG 結構的指標，這個方法會將開啟儲存對象的相關信息放在其中。如果發生錯誤，此參數為 NULL 。

[in] grfStatFlag

指定不會傳回 STATSTG 結構中的部分成員，因此儲存記憶體配置作業。值取自 STATFLAG 列舉。

傳回值

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	STATSTG 結構已成功在指定的位置傳回。
E_PENDING	僅限異步記憶體：目前無法使用部分或所有記憶體的數據。
STG_E_ACCESSDENIED	呼叫端沒有足夠的許可權可存取此記憶體對象的統計數據。
STG_E_INSUFFICIENTMEMORY	由於記憶體不足，所以不會傳回 STATSTG 結構。
STG_E_INVALIDFLAG	grfStateFlag 參數的值無效。
STG_E_INVALIDPARAMETER	其中一個參數無效。

備註

IStorage：：Stat 會擷取目前儲存物件的 STATSTG 結構。 STATSTG 結構包含記憶體對象的相關統計數據。 IStorage：：EnumElements 會傳回列舉值物件的指標。這個方法傳回的列舉值物件會實作 IEnumSTATSTG 介面，其中會列舉 儲存在 STATSTG 結構陣列中的數據。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	objidl.h
程式庫	Uuid.lib
Dll	Ole32.dll