IPropertySetter :: GetProps, méthode

Notes

[Déconseillé. Cette API peut être supprimée des futures versions de Windows.]

La GetProps méthode récupère les propriétés définies sur cet objet, avec leurs valeurs correspondantes.

Syntaxe

HRESULT GetProps(
  [out] LONG         *pcParams,
  [out] DEXTER_PARAM **paParam,
  [out] DEXTER_VALUE **paValue
);

Paramètres

pcParams [ à]

Reçoit le nombre de structures retournées dans paParam.

paParam [ à]

Adresse d’un pointeur vers un tableau de structures de _ paramètres Dexter .

paValue [ à]

Adresse d’un pointeur vers un tableau de structures de _ valeur Dexterity .

Valeur retournée

Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Pour chaque propriété retournée dans paParam, le membre nvaleurs indique le nombre de structures de _ valeur dexterisation associées à la propriété. Les paires sont retournées dans l’ordre chronologique croissant de chaque propriété.

Lorsque vous avez terminé d’utiliser les structures retournées, appelez IPropertySetter :: FreeProps pour libérer les ressources allouées par cette méthode.

Notes

Le fichier d’en-tête qedit. h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.

Notes

pour obtenir Qedit. h, téléchargez la mise à jour Microsoft Windows SDK pour Windows Vista et .NET Framework 3,0. Qedit. h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3,5 Service Pack 1.

Exemples

L’exemple de code suivant montre comment itérer au sein de toutes les valeurs sur une instance de l’accesseur Set de propriété :

IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).

DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;

hr = pSetter->GetProps(&count, &pParam, &pValue);

LONG num = 0;
for (LONG i = 0; i < count; i++)
{
    for (LONG j = 0; j < pParam[i].nValues; j++)
    {
        // pValue[num] is the next value in the sequence for pParam[i]
    }
    num += pParam[i].nValues;
}

Configuration requise

Condition requise Valeur
En-tête
Qedit. h
Bibliothèque
Strmiids. lib

Voir aussi

Interface IPropertySetter

Codes d’erreur et de réussite