Partager via


Méthode IPropertyStore ::GetCount (propsys.h)

Cette méthode retourne le nombre de propriétés attachées au fichier.

Syntaxe

HRESULT GetCount(
  DWORD *cProps
);

Paramètres

cProps

Pointeur vers une valeur qui indique le nombre de propriétés.

Valeur retournée

La IpropertyStore::GetCount méthode retourne une valeur de S_OK lorsque l’appel réussit, même si le fichier n’a aucune propriété attachée. Tout autre code retourné est un code d’erreur.

Remarques

IPropertyStore fournit une abstraction sur un tableau de clés de propriété via les IPropertyStore::GetCount méthodes et IPropertyStore ::GetAt . Les clés de propriété dans ce tableau représentent les propriétés qui sont actuellement stockées par l’IPropertyStore.

En GetCount cas de réussite, la valeur pointée par cProps est un nombre de clés de propriété dans le tableau. L’appelant peut s’attendre à ce que les appels à IPropertyStore ::GetAt réussissent pour des valeurs d’iProp inférieures à cProps.

En cas d’échecs tels que E_OUTOFMEMORY, vous devez définir cProps sur zéro. Il est préférable que des erreurs soient détectées lors de la création ou de l’initialisation du magasin de propriétés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible avec Windows Vista et les versions ultérieures du système d’exploitation Windows.
Plateforme cible Universal
En-tête propsys.h
Bibliothèque Propsys.idl
IRQL Tous les niveaux

Voir aussi

Ipropertystore

IPropertyStore ::GetAt