GdipGetPropertyIdList()

Resultat.i = GdipGetPropertyIdList(*image, numOfProperty.i, *list)

*image

[in] Pointeur sur un objet image. 

numOfProperty.i

[in] Nombre de propriétés de l'image. Utilisez la fonction GdipGetPropertyCount() pour déterminer ce nombre.

*list

[out] Pointeur sur la zone mémoire qui recevra les éléments PROPID de la liste des propriétés. PROPID est défini dans le fichier WTypes.h et est un ULONG (long non signé). Chaque valeur de la liste est un identifiant de propriété d'image (property tags) qui sont des éléments de l'énumération Image property ID tags.

Cette fonction permet d'obtenir la liste des propriétés stockée dans une image.
Les propriétés sont des informations comme la marque ou le modèle de l'appareil photo utilisé pour la capture de l'image. Chaque propriété est identifiée par une balise (ou tag) qui est un élément de l'énumération Image property ID tags.

La fonction GdipGetPropertyIdList() retourne un tableau d'éléments PROPID (long non signé) dans la zone mémoire qui doit avoir préalablement allouée. Avant d'appeler la fonction, vous devez allouer suffisamment de mémoire pour recevoir ce tableau d'éléments. Vous pouvez appeler la fonction GdipGetPropertyCount() pour définir la taille en octets de la mémoire nécessaire. La mémoire nécessaire est la multiplication de la valeur retournée dans le paramètre numOfProperty (fonction GdipGetPropertyCount()) par sizeof(PROPID).

L'exemple charge une image et l'affiche, retrouve le nombre de propriétés et affiche les types.

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.