這個方法會傳回附加至檔案的屬性數目計數。
語法
HRESULT GetCount(
DWORD *cProps
);
參數
cProps
指出屬性計數之值的指標。
傳回值
方法 IpropertyStore::GetCount 會在呼叫成功時傳回 S_OK的值,即使檔案沒有附加屬性也一樣。 傳回的任何其他程式代碼都是錯誤碼。
備註
IPropertyStore 透過 和 IPropertyStore::GetAt 方法,提供屬性索引鍵IPropertyStore::GetCount陣列的抽象概念。 這個陣列中的屬性索引鍵代表 IPropertyStore 目前儲存的屬性。
成功時 GetCount ,cProps 所指向的值是陣列中的屬性索引鍵計數。 呼叫端預期 iPropertyStore::GetAt 的呼叫會成功,而 iProp 小於 cProps 的值。
如果失敗,例如 E_OUTOFMEMORY,您應該將 cProps 設定為零。 最好是在建立或初始化屬性存放區期間發現錯誤。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 和更新版本的 Windows 作業系統。 |
| 目標平台 | Universal |
| 標頭 | propsys.h |
| 程式庫 | Propsys.idl |
| IRQL | 所有層級 |