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

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

Flags

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

플래그	설명
PSUIINFO_UNICODE	설정된 경우 호출 애플리케이션은 유니코드 문자를 사용합니다.

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에서 제공되며 모든 이유 값에 유효합니다.

UserData

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

Result

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

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

요구 사항

헤더	compstui.h(Compstui.h 포함)