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 con tipo PFNPROPSHEETUI de una aplicación.

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, vea la sección Comentarios 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, vea la sección Comentarios a continuación.

Comentarios

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 de tipo PFNPROPSHEETUI registradas, 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 miembros hSetResult y Result de la estructura son los valores lParam1 y lParam2 , respectivamente, que se proporcionaron a la función ComPropSheet 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 , proporcionando un recuento del número de funciones con tipo PFNPROPSHEETUI a las que se llamó.

Normalmente, la función PFNPROPSHEETUI de una aplicación establece el miembro Result de su estructura de PROPSHEETUI_INFO en el valor recibido en el miembro Result de la estructura 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 llamada posteriormente está asociada a una página que es el elemento primario de la página asociada a la última función llamada. Una función puede modificar el contenido del miembro Result de SETRESULT_INFO estructura, lo que hace que las funciones asociadas a las páginas principales reciban el nuevo valor.

Requisitos

Requisito	Valor
Header	compstui.h (incluir Compstui.h)