Compartir a través de

estructura PROPSHEETUI_INFO (compstui.h)

  • Artículo

La estructura de PROPSHEETUI_INFO se usa como parámetro de entrada para funciones de tipo PFNPROPSHEETUI.

Sintaxis

typedef struct _PROPSHEETUI_INFO {
  WORD            cbSize;
  WORD            Version;
  WORD            Flags;
  WORD            Reason;
  HANDLE          hComPropSheet;
  PFNCOMPROPSHEET pfnComPropSheet;
  LPARAM          lParamInit;
  ULONG_PTR       UserData;
  ULONG_PTR       Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;

Miembros

cbSize

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

Version

Número de versión proporcionado por CPSUI de la estructura PROPSHEETUI_INFO. El número de versión actual se define mediante PROPSHEETUI_INFO_VERSION en compstui.h.

Flags

Marcas de bits proporcionadas por CPSUI. Se define la marca siguiente:

Bandera Descripción
PSUIINFO_UNICODE Si se establece, la aplicación que realiza la llamada usa caracteres Unicode.

Reason

Constante proporcionada por CPSUI que especifica la acción que se va a realizar en la hoja de propiedades mediante el PFNPROPSHEETUIfunción con tipo a la que se pasó la estructura PROPSHEETUI_INFO. Se proporcionará una de las siguientes constantes:

  • PROPSHEETUI_REASON_DESTROY

  • PROPSHEETUI_REASON_GET_ICON

  • PROPSHEETUI_REASON_GET_INFO_HEADER

  • PROPSHEETUI_REASON_INIT

  • PROPSHEETUI_REASON_SET_RESULT

Para obtener información sobre el significado de cada constante, vea la sección Comentarios de la PFNPROPSHEETUI descripción.

hComPropSheet

Identificador proporcionado por CPSUI a una hoja de propiedades grupo primario. Este identificador se puede pasar a la función ComPropSheet de CPSUI.

pfnComPropSheet

Dirección de la función ComPropSheet de CPSUI.

lParamInit

Valor recibido como parámetro lParam para la función de tipo PFNPROPSHEETUI asociada, cuando se llamó a la función por primera vez con un Reason de PROPSHEETUI_REASON_INIT. Para obtener información sobre lo que puede ser este valor, vea la descripción de PFNPROPSHEETUI.

CpSUI proporciona este valor y es válido para todos los valores Reason.

UserData

Opcional, valor privado o puntero proporcionado por el PFNPROPSHEETUI asociadofunción con tipo, establecido inicialmente en cero por CPSUI. Si la función almacena un valor en UserData, para las llamadas posteriores a la función, el valor almacenado o el puntero no se modifican a menos que la función cambie.

Result

Valor de resultado proporcionado por el PFNPROPSHEETUI asociadofunción con tipo, establecido inicialmente en cero por CPSUI. Si la función almacena un valor de resultado en Result, para las llamadas posteriores a la función, el valor almacenado no se modifica a menos que la función cambie.

Si la dirección de la función con tipo PFNPROPSHEETUI se especificó como argumento para CommonPropertySheetUI, el último valor almacenado en Result se devuelve a CommonPropertySheetUI en la ubicación a la que apunta su argumento pResult.

Requisitos

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