estructura SETRESULT_INFO (compstui.h)

La estructura SETRESULT_INFO se usa como parámetro de entrada para la función de devolución de llamada PFNPROPSHEETUI de una aplicacióncon tipo.

Sintaxis

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

Miembros

cbSize

Tamaño proporcionado por CPSUI, en bytes, de la estructura SETRESULT_INFO.

wReserved

Reservado.

hSetResult

Identificador proporcionado por CPSUI a una página de hoja de propiedades agregada, obtenida de la aplicación. Para obtener más información, consulte la sección comentarios de a continuación.

Result

Identificador proporcionado por CPSUI a una página de hoja de propiedades agregada, obtenida de la aplicación. Para obtener más información, consulte la sección comentarios de a continuación.

Observaciones

Cuando una aplicación llama a la función ComPropSheet de CPSUI, especificando un código de función de CPSFUNC_SET_RESULT, CPSUI llama a todas las funciones PFNPROPSHEETUIregistradas, especificando un motivo de PROPSHEETUI_REASON_SET_RESULT. Al especificar este motivo, CPSUI también proporciona una estructura SETRESULT_INFO.

Los valores contenidos en los hSetResult de la estructura y miembros result son los lParam1 y valores de lParam2, respectivamente, que se proporcionaron a la función ComProp Sheet de CPSUI.

Se llama a cada una de las funciones de tipo PFNPROPSHEETUI de la aplicación en orden, desde la última declarada a la primera declarada, hasta que una de estas funciones proporciona un valor devuelto de menos de uno. En ese momento, CPSUI devuelve de su función ComPropSheet, lo que proporciona un recuento del número de funciones con tipo PFNPROPSHEETUI a las que se llamó.

Normalmente, la función de tipo PFNPROPSHEETUI de una aplicación establece el miembro de Result de su estructura de PROPSHEETUI_INFO en el valor recibido en el miembro Result de la estructura de SETRESULT_INFO. A continuación, la función devuelve un valor de 1 (o superior), por lo que la siguiente función con tipo PFNPROPSHEETUI también puede recibirla. Cada función denominada posteriormente está asociada a una página que es el elemento primario de la página asociada a la función llamada por última vez. Una función puede modificar el contenido de SETRESULT_INFO miembro de resultado, lo que hace que las funciones asociadas a las páginas principales reciban el nuevo valor.

Requisitos

Requisito	Valor
encabezado de	compstui.h (include Compstui.h)