PFNPROPSHEETUI 콜백 함수(compstui.h)

아티클
02/06/2025

PFNPROPSHEETUI 함수 형식은 CPSUI 애플리케이션(프린터 인터페이스 DLL 포함)에서 생성할 속성 시트 페이지를 지정하는 페이지 만들기 콜백정의하는 데 사용됩니다.

통사론

PFNPROPSHEETUI Pfnpropsheetui;

LONG Pfnpropsheetui(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
)
{...}

매개 변수

pPSUIInfo

PROPSHEETUI_INFO 구조체에 대한 CPSUI 제공 포인터입니다.

lParam

PROPSHEETUI_INFO 구조체의 Reason 멤버의 내용에 따라 달라지는 CPSUI 제공 정수 값입니다. 유효한 값은 다음과 같습니다.

PROPSHEETUI_REASON_BEFORE_INIT

이 값은 Windows 8에 새로 추가되었으며 CommonPropertySheetUI전달된 원래 PFNPROPSHEETUI 매개 변수에만 제공됩니다.

PROPSHEETUI_REASON_DESTROY

사용자가 속성 시트의 확인 또는 취소 단추를 선택한 경우 lParam 값은 0이 아닌 값입니다. 그렇지 않으면 값이 0입니다.

PROPSHEETUI_REASON_GET_ICON

lParam 값은 PROPSHEETUI_GETICON_INFO 구조체에 대한 포인터입니다.

PROPSHEETUI_REASON_GET_INFO_HEADER

lParam 값은 PROPSHEETUI_INFO_HEADER 구조체에 대한 포인터입니다.

PROPSHEETUI_REASON_INIT

pfnPropSheetUI 매개 변수를 사용하여 CommonPropertySheetUI 콜백 함수를 지정하는 경우 lParamCommonPropertySheetUI전달되는 lParam 값입니다.

CPSUI의 ComPropSheet 함수와 함께 CPSFUNC_ADD_PFNPROPSHEETUI 함수 코드를 사용하여 콜백 함수를 지정하는 경우 lParamComPropSheet전달되는 lParam2 값입니다.

CPSUI는 lParam 값을 함수 PROPSHEETUI_INFO 구조의 lParamInit 멤버에 복사합니다.

lParam 값은 애플리케이션의 스택에 있지 않아야 합니다.

PROPSHEETUI_REASON_SET_RESULT

lParam 값은 SETRESULT_INFO 구조체에 대한 포인터입니다.

반환 값

작업이 성공하면 함수는 하나 이상의 값을 반환해야 합니다. 그렇지 않으면 1보다 작은 값을 반환해야 합니다.

반환 코드	묘사
하나 이상.	현재 페이지의 부모와 연결된 PFNPROPSHEETUI 함수가 호출됩니다.
1보다 작습니다.	현재 페이지의 부모와 연결된 PFNPROPSHEETUI 함수는 호출되지 않습니다.

발언

PFNPROPSHEETUI 함수 형식을 사용하여 지정된 콜백 함수는 CPSUI 사용하여 사용자 지정된 속성 시트 페이지를 관리하는 애플리케이션에서 제공합니다. 애플리케이션에서 CommonPropertySheetUI 함수를 호출할 때 이러한 콜백 함수 중 하나를 지정해야 합니다. 예를 들어 NT 기반 운영 체제 인쇄 스풀러가 CPSUI의 CommonPropertySheetUI 함수를 호출하여 DocumentProperties 또는 PrinterProperties 함수를 지원하는 경우 스풀러는 내부 PFNPROPSHEETUI 형식 콜백 함수를 지정합니다.

애플리케이션은 CPSFUNC_ADD_PFNPROPSHEETUI함수 코드를 사용하여 CPSUI의 ComPropSheet 함수를 호출하여 추가 PFNPROPSHEETUI 형식 콜백 함수를 지정할 수 있습니다. 예를 들어 NT 기반 운영 체제 인쇄 스풀러는 프린터 인터페이스 DLL의 DrvDocumentPropertySheets 및 drvDevicePropertySheets 함수를 CPSUI에 알리기 위해 이 작업을 수행합니다. 마찬가지로 Microsoft의 Unidrv 및 Pscript 드라이버는 이 기술을 사용하여 사용자 인터페이스 플러그 인 IPrintOemUI::D cumentPropertySheets 및 IPrintOemUI::D evicePropertySheets 메서드가 있음을 CPSUI에 알립니다.

각 PFNPROPSHEETUI 형식 콜백 함수는 CPSUI에서 여러 번 호출됩니다. PROPSHEETUI_INFO 구조체의 이유 멤버는 다음과 같이 함수가 수행해야 하는 작업을 규정합니다.

요구 사항

요구	값
대상 플랫폼	바탕 화면
헤더	compstui.h(Compstui.h 포함)

다음을 통해 공유