struttura SETRESULT_INFO (compstui.h)

La struttura SETRESULT_INFO viene usata come parametro di input per la funzione di callback tipizzata PFNPROPSHEETUI di un'applicazione.

Sintassi

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

Members

cbSize

Dimensioni fornite da CPSUI, in byte, della struttura SETRESULT_INFO .

wReserved

Riservato.

hSetResult

Handle fornito da CPSUI a una pagina della finestra delle proprietà aggiunta, ottenuta dall'applicazione. Per altre informazioni, vedere la sezione Osservazioni di seguito.

Result

Handle fornito da CPSUI a una pagina della finestra delle proprietà aggiunta, ottenuta dall'applicazione. Per altre informazioni, vedere la sezione Osservazioni di seguito.

Commenti

Quando un'applicazione chiama la funzione ComPropSheet di CPSUI, specificando un codice di funzione di CPSFUNC_SET_RESULT, CPSUI chiama tutte le funzioni pfNPROPSHEETUI registrate, specificando un motivo di PROPSHEETUI_REASON_SET_RESULT. Quando si specifica questo motivo, CPSUI fornisce anche una struttura SETRESULT_INFO .

I valori contenuti nei membri hSetResult e Result della struttura sono rispettivamente i valori lParam1 e lParam2 forniti alla funzione ComPropSheet di CPSUI.

Ognuna delle funzioni di tipo PFNPROPSHEETUI dell'applicazione viene chiamata in ordine, da quella dichiarata più di recente alla prima dichiarata, fino a quando una di queste funzioni fornisce un valore restituito minore di uno. A questo punto, CPSUI restituisce dalla relativa funzione ComPropSheet , fornendo un conteggio del numero di funzioni tipate PFNPROPSHEETUI chiamate.

In genere, la funzione tipizzata PFNPROPSHEETUI di un'applicazione imposta il membro Result della relativa struttura PROPSHEETUI_INFO sul valore ricevuto nel membro Result della struttura SETRESULT_INFO. La funzione restituisce quindi un valore pari a 1 (o superiore), quindi la funzione tipizzata PFNPROPSHEETUI successiva può anche riceverla. Ogni funzione chiamata successivamente è associata a una pagina padre della pagina associata all'ultima funzione chiamata. Una funzione può modificare il contenuto del membro Result della struttura SETRESULT_INFO, causando la ricezione del nuovo valore delle funzioni associate alle pagine padre.

Requisiti

Requisito	Valore
Intestazione	compstui.h (include Compstui.h)