CommonPropertySheetUIA 함수(compstui.h)

  • 아티클

CPSUI의 CommonPropertySheetUI 함수는 속성 시트 페이지를 표시하고 사용자가 표시된 값을 수정할 수 있도록 합니다.

구문

LONG CommonPropertySheetUIA(
  HWND           hWndOwner,
  PFNPROPSHEETUI pfnPropSheetUI,
  LPARAM         lParam,
  LPDWORD        pResult
);

매개 변수

hWndOwner

새 속성 시트 페이지를 배치할 창을 식별하는 호출자 제공 창 핸들입니다.

pfnPropSheetUI

PFNPROPSHEETUI 형식 콜백 함수에 대한 호출자 제공 포인터입니다.

lParam

pfnPropSheetUI 함수에 대한 입력 인수로 사용되는 호출자 제공 값입니다. 이 값은 포인터일 수 있습니다.

pResult

pfnPropSheetUI 함수의 최종 반환 상태 수신하는 DWORD에 대한 호출자 제공 포인터입니다. NULL이면 최종 반환 상태 반환되지 않습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

CommonPropertySheetUI 함수는 다음 값 중 하나를 반환합니다.

반환 코드 설명
CPSUI_CANCEL pfnPropSheetUI 함수는 음수 값을 반환했습니다.
CPSUI_OK 작업에 성공했습니다.
CPSUI_REBOOTSYSTEM 작업이 성공했고 대화 상자 프로시저가 PSM_REBOOTSYSTEM 메시지를 보냈습니다.
CPSUI_RESTARTWINDOWS 작업이 성공했고 대화 상자 프로시저가 PSM_RESTARTWINDOWS 메시지를 보냈습니다.
ERR_CPSUI 접두사 오류 코드 오류가 발생했습니다. ERR_CPSUI 접두사 오류 코드는 compstui.h에 정의되어 있습니다.

설명

CommonPropertySheetUI 함수는 애플리케이션에 대한 CPSUI의 진입점입니다. CPSUI 애플리케이션(예: Microsoft NT 기반 운영 체제 인쇄 스풀러)은 함수를 호출하여 미리 정의된 부모 창에 하나 이상의 속성 시트 페이지를 추가할 수 있습니다. CPSUI는 페이지를 표시하고, 사용자가 페이지를 수정할 수 있도록 하며, 콜백 함수를 통해 사용자 활동 애플리케이션에 알깁니다.

Win32 애플리케이션이 스풀러의 DocumentProperties 또는 PrinterProperties 함수를 호출할 때 NT 기반 운영 체제 인쇄 스풀러는 CommonPropertySheetUI 함수를 호출합니다.

pfnPropSheetUI 매개 변수로 지정된 콜백 함수는 추가할 속성 시트 페이지를 설명합니다. 자세한 내용은 PFNPROPSHEETUI 함수 형식에 대한 설명을 참조하세요.

작업 시퀀스는 다음과 같습니다.

  1. CommonPropertySheetUI 함수는 pfnPropSheetUI 콜백을 호출하므로 콜백은 CPSUI의 ComPropSheet 함수를 호출하여 추가할 페이지를 설명할 수 있습니다.

  2. pfnPropSheetUI 콜백이 성공하면 CommonPropertySheetUI 함수는 새 속성 시트 페이지를 표시하고 사용자가 페이지 값을 수정할 수 있도록 합니다.

  3. 사용자가 페이지 값을 수정하면 페이지 이벤트 콜백 이 애플리케이션에 변경 내용을 알 수 있습니다.

  4. 사용자가 확인 또는 취소 단추를 선택하면 CommonPropertySheetUI 함수는 표시된 페이지를 삭제하고 를 반환합니다.

작업 순서에 대한 자세한 내용은 CPSUI 섹션의 프린터 드라이버에서 CPSUI 사용을 참조하세요.

CommonPropertySheetUI 함수는 실제로 pfnPropSheetUI 콜백을 여러 번 호출하여 콜백의 PROPSHEETUI_INFO 구조에 서로 다른 Reason 멤버 값을 지정합니다. 콜백이 반환할 때마다 결과 상태 PROPSHEETUI_INFO 구조체의 Result 멤버에 배치됩니다. CommonPropertySheetUI 함수가 반환되면 Result 의 최종 내용을 pResult가 가리키는 위치에 복사합니다.

요구 사항

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