IPropertyStore::GetCount 方法 (propsys.h)

此方法返回附加到文件的属性数的计数。

语法

HRESULT GetCount(
  DWORD *cProps
);

参数

cProps

指向指示属性计数的值的指针。

返回值

调用成功时,方法 IpropertyStore::GetCount 返回值 S_OK,即使文件没有附加任何属性也是如此。 返回的任何其他代码都是错误代码。

注解

IPropertyStore 通过 IPropertyStore::GetCountIPropertyStore::GetAt 方法对属性键数组提供抽象。 此数组中的属性键表示 当前由 IPropertyStore 存储的属性。

成功时 GetCount ,cProps 指向的值是数组中属性键的计数。 对于小于 cProps 的 iProp 值,调用方可以期望对 IPropertyStore::GetAt 的调用成功。

如果发生故障(如E_OUTOFMEMORY),应将 cProps 设置为零。 最好是在创建或初始化属性存储期间发现错误。

要求

要求
最低受支持的客户端 适用于 Windows Vista 和更高版本的 Windows 操作系统。
目标平台 通用
标头 propsys.h
Library Propsys.idl
IRQL 所有级别

另请参阅

IPropertyStore

IPropertyStore::GetAt