ISpecifyPropertyPages ::GetPages, méthode (ocidl.h)

Récupère la liste des pages de propriétés qui peuvent être affichées dans la feuille des propriétés de cet objet.

Syntaxe

HRESULT GetPages(
  [out] CAUUID *pPages
);

Paramètres

[out] pPages

Pointeur vers une structure CAUUID allouée par l’appelant que la fonction initialise et remplit avant de retourner. Le membre pElems dans la structure est alloué par la fonction avec CoTaskMemAlloc et doit être libéré par l’appelant avec CoTaskMemFree.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_POINTER	L’adresse dans pPages n’est pas valide. Par exemple, il peut s’agir de NULL.

Remarques

La structure CAUUID est allouée par l’appelant, mais n’est pas initialisée par l’appelant. La méthode GetPages remplit le membre cElements dans la structure. Cette méthode alloue également de la mémoire au tableau pointé par le membre pElems à l’aide de CoTaskMemAlloc. Ensuite, il remplit le tableau nouvellement alloué. Une fois cette méthode retournée avec succès, la structure contient un tableau compté d’UUIDs, chaque UUID spécifiant un CLSID de page de propriétés.

Remarques aux appelants

L’appelant doit libérer la mémoire pointée par le membre pElems de CAUUID, à l’aide de CoTaskMemFree quand elle n’est plus nécessaire.

Remarques aux implémenteurs

E_NOTIMPL n’est pas autorisé en tant que valeur de retour, car un objet sans pages de propriétés ne doit pas exposer l’interface ISpecifyPropertyPages .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

ISpecifyPropertyPages