PFNPROPSHEETUI 콜백 함수(compstui.h)

아티클
02/26/2024

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

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

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	compstui.h(Compstui.h 포함)

다음을 통해 공유