macro PropSheet_GetResult (prsht.h)

Article
10/24/2024

Utilisé par les feuilles de propriétés sans mode pour récupérer les informations retournées aux feuilles de propriétés modales par PropertySheet. Vous pouvez utiliser cette macro ou envoyer explicitement le message PSM_GETRESULT.

Syntaxe

int PropSheet_GetResult(
   HWND hDlg
);

Paramètres

hDlg

Type : HWND

Gérer la boîte de dialogue de la feuille de propriétés.

Valeur de retour

Type : int

Retourne une valeur positive si elle réussit ou -1 sinon. Les valeurs de retour suivantes ont une signification particulière.

Retourner le code	Description
ID_PSREBOOTSYSTEM	Une page a envoyé un message PSM_REBOOTSYSTEM à la feuille de propriétés. L’ordinateur doit être redémarré pour que les modifications de l’utilisateur prennent effet.
ID_PSRESTARTWINDOWS	Une page a envoyé un message PSM_RESTARTWINDOWS à la feuille de propriétés. Windows doit être redémarré pour que les modifications de l’utilisateur prennent effet.

Remarques

Pour récupérer des informations d’erreur étendues, appelez GetLastError.

La valeur de retour est identique à ce que PropertySheet aurait retourné s’il s’agit d’une feuille de propriétés modale.

Version 5.80. La PropertySheet valeur de retour contient différentes informations pour les feuilles de propriétés modales et sans mode. Dans certains cas, les feuilles de propriétés sans mode peuvent avoir besoin des informations qu’elles auraient reçues de PropertySheet si elles avaient été modales. En particulier, ils peuvent avoir besoin de savoir si ID_PSREBOOTSYSTEM ou ID_PSRESTARTWINDOWS auraient été renvoyés.

Pour une feuille de propriétés sans mode, votre boucle de message doit utiliser PSM_ISDIALOGMESSAGE pour transmettre des messages à la boîte de dialogue feuille de propriétés et PSM_GETCURRENTPAGEHWND déterminer quand détruire la boîte de dialogue. Lorsque l’utilisateur clique sur le bouton OK ou Annuler, PSM_GETCURRENTPAGEHWND retourne NULL. Vous pouvez ensuite récupérer la valeur qu’une feuille de propriétés modale aurait reçue de PropertySheet en envoyant un message PSM_GETRESULT.

Remarque Cette macro n’est pas prise en charge lors de l’utilisation du style de l’Assistant Aero (PSH_AEROWIZARD).

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	prsht.h

Partager via