macro PropSheet_GetResult (prsht.h)

Articolo
10/24/2024

Utilizzato dalle finestre delle proprietà senza modalità per recuperare le informazioni restituite alle finestre delle proprietà modali da PropertySheet. È possibile utilizzare questa macro o inviare il messaggio di PSM_GETRESULT in modo esplicito.

Sintassi

int PropSheet_GetResult(
   HWND hDlg
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra di dialogo della finestra di dialogo della finestra di proprietà.

Valore restituito

Tipo: int

Restituisce un valore positivo se ha esito positivo o -1 in caso contrario. I valori restituiti seguenti hanno un significato speciale.

Codice restituito	Descrizione
ID_PSREBOOTSYSTEM	Una pagina ha inviato un messaggio di PSM_REBOOTSYSTEM alla finestra delle proprietà. Per rendere effettive le modifiche dell'utente, è necessario riavviare il computer.
ID_PSRESTARTWINDOWS	Una pagina ha inviato un messaggio di PSM_RESTARTWINDOWS alla finestra delle proprietà. Windows deve essere riavviato per rendere effettive le modifiche dell'utente.

Osservazioni

Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Il valore restituito è identico a quello che PropertySheet avrebbe restituito se si trattasse di una finestra delle proprietà modale.

Versione 5.80. Il valore restituito PropertySheet contiene informazioni diverse per le finestre delle proprietà modali e non modali. In alcuni casi, le finestre delle proprietà modeless potrebbero richiedere le informazioni che avrebbero ricevuto da PropertySheet se fossero state modali. In particolare, potrebbe essere necessario sapere se ID_PSREBOOTSYSTEM o ID_PSRESTARTWINDOWS sarebbe stato restituito.

Per una finestra delle proprietà senza modalità, il ciclo di messaggi deve utilizzare PSM_ISDIALOGMESSAGE per passare messaggi alla finestra di dialogo della finestra di proprietà e PSM_GETCURRENTPAGEHWND determinare quando eliminare definitivamente la finestra di dialogo. Quando l'utente fa clic sul pulsante OK o Annulla, PSM_GETCURRENTPAGEHWND restituisce NULL. È quindi possibile recuperare il valore ricevuto da una finestra delle proprietà modale da PropertySheet inviando un messaggio di PSM_GETRESULT.

Nota Questa macro non è supportata quando si utilizza lo stile della procedura guidata Aero (PSH_AEROWIZARD).

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	prsht.h

Condividi tramite