struttura SETRESULT_INFO (compstui.h)

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

Sintassi

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

Membri

cbSize

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

wReserved

Riservato.

hSetResult

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

Result

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

Osservazioni

Quando un'applicazione chiama funzione ComPropSheet di CPSUI, specificando un codice di funzione di CPSFUNC_SET_RESULT, CPSUI chiama tutte le funzioni registrate PFNPROPSHEETUI-typed, 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 sono rispettivamente i valori lParam1 e lParam2 forniti rispettivamente alla funzione ComPropSheet CPSUI.

Ogni funzione tipizzata PFNPROPSHEETUI dell'applicazione viene chiamata in ordine, da quella dichiarata più di recente al primo dichiarato, fino a quando una di queste funzioni non fornisce un valore restituito minore di uno. A questo punto, CPSUI restituisce dalla 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 struttura PROPSHEETUI_INFO sul valore ricevuto nel membro Result della struttura SETRESULT_INFO. La funzione restituisce quindi un valore pari a 1 (o maggiore), 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 di SETRESULT_INFO, causando la ricezione del nuovo valore delle funzioni associate alle pagine padre.

Fabbisogno

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