PFNPROPSHEETUI 콜백 함수(compstui.h)

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로 콜백 함수를 지정하는 경우 lParam은 CommonPropertySheetUI에 전달된 lParam 값입니다.

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

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

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

PROPSHEETUI_REASON_SET_RESULT

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

반환 값

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

설명

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 ocumentPropertySheets 및 IPrintOemUI::D evicePropertySheets 메서드가 있는지 CPSUI에 알립니다.

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

요구 사항