Skip to content

Latest commit

 

History

History
80 lines (62 loc) · 3.11 KB

nf-propsys-ipropertystore-getcount.md

File metadata and controls

80 lines (62 loc) · 3.11 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:propsys.IPropertyStore.GetCount
IPropertyStore::GetCount (propsys.h)
This method returns a count of the number of properties that are attached to the file.
GetCount
GetCount (IPropertyStore)
GetCount method [Audio Devices]
GetCount method [Audio Devices]
IPropertyStore interface
IPropertyStore interface [Audio Devices]
GetCount method
IPropertyStore.GetCount
IPropertyStore::GetCount
audio.ipropertystore_getcount
audio_syseffects_r_2670eef9-2f2a-4e3d-8a43-d8d61a9ebce5.xml
propsys/IPropertyStore::GetCount
audio\ipropertystore_getcount.htm
audio
23f7b982-29db-4960-9a1d-2f9e033ebf61
12/05/2018
GetCount, GetCount (IPropertyStore), GetCount method [Audio Devices], GetCount method [Audio Devices],IPropertyStore interface, IPropertyStore interface [Audio Devices],GetCount method, IPropertyStore.GetCount, IPropertyStore::GetCount, audio.ipropertystore_getcount, audio_syseffects_r_2670eef9-2f2a-4e3d-8a43-d8d61a9ebce5.xml, propsys/IPropertyStore::GetCount
propsys.h
Universal
Available with Windows Vista and later versions of the Windows operating system.
Propsys.idl
All levels
Windows
19H1
IPropertyStore::GetCount
propsys/IPropertyStore::GetCount
c++
APIRef
kbSyntax
COM
Propsys.idl
Propsys.idl.dll
IPropertyStore.GetCount

IPropertyStore::GetCount

-description

This method returns a count of the number of properties that are attached to the file.

-parameters

-param cProps

A pointer to a value that indicates the property count.

-returns

The IpropertyStore::GetCount method returns a value of S_OK when the call is successful, even if the file has no properties attached. Any other code returned is an error code.

-remarks

IPropertyStore provides an abstraction over an array of property keys via the IPropertyStore::GetCount and IPropertyStore::GetAt methods. The property keys in this array represent the properties that are currently stored by the IPropertyStore.

When GetCount succeeds, the value pointed to by cProps is a count of property keys in the array. The caller can expect calls to IPropertyStore::GetAt to succeed for values of iProp less than cProps.

In the case of failures such as E_OUTOFMEMORY, you should set cProps to zero. It is preferable that errors are discovered during creation or initialization of the property store.

-see-also

IPropertyStore

IPropertyStore::GetAt