PROPSHEETUI_INFO 구조체(compstui.h)

PROPSHEETUI_INFO 구조체는 PFNPROPSHEETUI 형식 함수에 대한 입력 매개 변수로 사용됩니다.

구문

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;

멤버

cbSize

PROPSHEETUI_INFO 구조체 의 CPSUI 제공 크기(바이트)입니다.

Version

CPSUI에서 제공하는 PROPSHEETUI_INFO 구조체의 버전 번호입니다. 현재 버전 번호는 compstui.h의 PROPSHEETUI_INFO_VERSION 정의됩니다.

Flags

CPSUI 제공 비트 플래그입니다. 다음 플래그가 정의됩니다.

Reason

PROPSHEETUI_INFO 구조체가 전달된 PFNPROPSHEETUI 형식 함수에 의해 속성 시트에서 수행할 작업을 지정하는 CPSUI 제공 상수입니다. 다음 상수 중 하나가 제공됩니다.

• PROPSHEETUI_REASON_DESTROY

• PROPSHEETUI_REASON_GET_ICON

• PROPSHEETUI_REASON_GET_INFO_HEADER

• PROPSHEETUI_REASON_INIT

• PROPSHEETUI_REASON_SET_RESULT

각 상수의 의미에 대한 자세한 내용은 PFNPROPSHEETUI 설명의 설명 섹션을 참조하세요.

hComPropSheet

속성 시트 그룹 부모에 대한 CPSUI 제공 핸들입니다. 이 핸들은 CPSUI의 ComPropSheet 함수에 전달할 수 있습니다.

pfnComPropSheet

CPSUI의 ComPropSheet 함수 주소입니다.

lParamInit

함수가 PROPSHEETUI_REASON_INIT 이유로 처음 호출되었을 때 연결된 PFNPROPSHEETUI 형식 함수에 대한 lParam 매개 변수로 수신된 값입니다. 이 값에 대한 자세한 내용은 PFNPROPSHEETUI에 대한 설명을 참조하세요.

이 값은 CPSUI에서 제공하며 모든 Reason 값에 유효합니다.

UserData

연결된 PFNPROPSHEETUI 형식 함수에서 제공하는 선택적 프라이빗 값 또는 포인터이며, 처음에는 CPSUI에 의해 0으로 설정됩니다. 함수가 UserData에 값을 저장하는 경우 함수에 대한 후속 호출의 경우 함수에서 변경하지 않는 한 저장된 값 또는 포인터는 변경되지 않습니다.

Result

연결된 PFNPROPSHEETUI 형식 함수에서 제공하는 결과 값으로, 처음에 CPSUI에 의해 0으로 설정됩니다. 함수가 결과 값을 Result에 저장하는 경우 함수에 대한 후속 호출의 경우 함수에서 변경하지 않는 한 저장된 값은 변경되지 않습니다.

PFNPROPSHEETUI 형식 함수의 주소가 CommonPropertySheetUI에 대한 인수로 지정된 경우 Result에 저장된 마지막 값은 pResult 인수가 가리키는 위치에서 CommonPropertySheetUI로 반환됩니다.

요구 사항