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 |