structure SETRESULT_INFO (compstui.h)

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

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, obtenue à 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, obtenue à 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, le CPSUI appelle toutes les fonctions inscrites PFNPROPSHEETUI-typées, 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 hSetResult de la structure et les membres Result sont les valeurs lParam1 et lParam2, respectivement, qui ont été fournies à la fonction ComPropSheet de CPSUI.

Chacune des fonctions typées PFNPROPSHEETUI de l’application est appelée dans l’ordre, de celui qui a été déclaré le plus récemment au premier déclaré, jusqu’à ce qu’une de ces fonctions fournisse une valeur de retour inférieure à une. À ce stade, CPSUI retourne à partir de sa fonction ComPropSheet, fournissant le nombre de fonctions typées PFNPROPSHEETUI appelées.

En règle générale, la fonction PFNPROPSHEETUI d’une application définit le membre Result de sa structure de 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 PFNPROPSHEETUI suivante peut également la recevoir. Chaque fonction appelée par la suite 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.

Exigences

Exigence	Valeur
d’en-tête	compstui.h (include Compstui.h)