SETRESULT_INFO 구조체(compstui.h)

SETRESULT_INFO 구조체는 애플리케이션의 PFNPROPSHEETUI 형식 콜백 함수에 대한 입력 매개 변수로 사용됩니다.

구문

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

멤버

cbSize

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

wReserved

예약되어 있습니다.

hSetResult

애플리케이션에서 가져온 추가된 속성 시트 페이지에 대한 CPSUI 제공 핸들입니다. 자세한 내용은 아래 의 설명 섹션을 참조하세요.

Result

애플리케이션에서 가져온 추가된 속성 시트 페이지에 대한 CPSUI 제공 핸들입니다. 자세한 내용은 아래 의 설명 섹션을 참조하세요.

설명

애플리케이션이 CPSUI의 ComPropSheet 함수를 호출하고 CPSFUNC_SET_RESULT 함수 코드를 지정하는 경우 CPSUI는 등록된 모든 PFNPROPSHEETUI 형식 함수를 호출하고 PROPSHEETUI_REASON_SET_RESULT 이유를 지정합니다. 이러한 이유를 지정할 때 CPSUI는 SETRESULT_INFO 구조도 제공합니다.

구조체의 hSetResult 및 Result 멤버에 포함된 값은 각각 CPSUI의 ComPropSheet 함수에 제공된 lParam1 및 lParam2 값입니다.

각 애플리케이션의 PFNPROPSHEETUI 형식 함수는 가장 최근에 선언된 함수부터 선언된 첫 번째 함수까지 순서대로 호출되며, 이러한 함수 중 하나가 1보다 작은 반환 값을 제공합니다. 이 시점에서 CPSUI는 ComPropSheet 함수에서 를 반환하여 호출된 PFNPROPSHEETUI 형식 함수의 수를 제공합니다.

일반적으로 애플리케이션의 PFNPROPSHEETUI 형식 함수는 PROPSHEETUI_INFO 구조체의 Result 멤버를 SETRESULT_INFO 구조체 의 Result 멤버에서 받은 값으로 설정합니다. 그런 다음 함수는 1 이상의 값을 반환하므로 다음 PFNPROPSHEETUI 형식 함수도 받을 수 있습니다. 이후에 호출된 각 함수는 마지막으로 호출된 함수와 연결된 페이지의 부모인 페이지와 연결됩니다. 함수는 SETRESULT_INFO 구조체의 Result 멤버의 내용을 수정하여 부모 페이지와 연결된 함수가 새 값을 받도록 할 수 있습니다.

요구 사항