structure SETRESULT_INFO (compstui.h)

La structure SETRESULT_INFO est utilisée comme paramètre d’entrée pour la fonction de rappel de type PFNPROPSHEETUI d’une application.

Syntaxe

typedef struct _SETRESULT_INFO {
  WORD    cbSize;
  WORD    wReserved;
  HANDLE  hSetResult;
  LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;

Membres

cbSize

Taille fournie par CPSUI, en octets, de la structure SETRESULT_INFO .

wReserved

Réservé.

hSetResult

Handle fourni par CPSUI à une page de feuille de propriétés ajoutée, obtenu à partir de l’application. Pour plus d’informations, consultez la section Remarques ci-dessous.

Result

Handle fourni par CPSUI à une page de feuille de propriétés ajoutée, obtenu à partir de l’application. Pour plus d’informations, consultez la section Remarques ci-dessous.

Remarques

Lorsqu’une application appelle la fonction ComPropSheet de CPSUI, en spécifiant un code de fonction de CPSFUNC_SET_RESULT, CPSUI appelle toutes les fonctions de type PFNPROPSHEETUI inscrites, en spécifiant une raison de PROPSHEETUI_REASON_SET_RESULT. Lorsque vous spécifiez cette raison, CPSUI fournit également une structure SETRESULT_INFO .

Les valeurs contenues dans les membres hSetResult et Result de la structure sont les valeurs lParam1 et lParam2 , respectivement, qui ont été fournies à la fonction ComPropSheet de CPSUI.

Chacune des fonctions de type PFNPROPSHEETUI de l’application est appelée dans l’ordre, de la dernière déclaration à la première déclarée, jusqu’à ce qu’une de ces fonctions fournisse une valeur de retour inférieure à une. À ce stade, CPSUI retourne à partir de sa fonction ComPropSheet , en fournissant le nombre de fonctions de type PFNPROPSHEETUI appelées.

En règle générale, la fonction de type PFNPROPSHEETUI d’une application définit le membre Result de sa structure PROPSHEETUI_INFO sur la valeur reçue dans le membre Result de la structure SETRESULT_INFO. Ensuite, la fonction retourne une valeur de 1 (ou supérieure), de sorte que la fonction de type PFNPROPSHEETUI suivante peut également la recevoir. Chaque fonction appelée ultérieurement est associée à une page qui est le parent de la page associée à la dernière fonction appelée. Une fonction peut modifier le contenu du membre Result de SETRESULT_INFO structure, ce qui entraîne la réception de la nouvelle valeur par les fonctions associées aux pages parentes.

Configuration requise

Condition requise	Valeur
En-tête	compstui.h (inclure Compstui.h)