다음을 통해 공유


MMCPropPageCallback 함수(mmc.h)

MMCPropPageCallback 함수는 MFC(Microsoft Foundation Classes) 기반 스냅인에서만 필요합니다. 함수는 페이지를 만드는 동안 올바른 모듈 상태를 설정합니다.

구문

HRESULT MMCPropPageCallback(
  void *vpsp
);

매개 변수

vpsp

Microsoft Windows PROPSHEETPAGE 구조체에 대한 포인터입니다. 기본적으로 MFC는 구조체의 pfnCallback 멤버에 자체 콜백을 설치합니다.

반환 값

이 콜백 함수는 이러한 값 중 하나를 반환할 수 있습니다.

설명

이 함수는 MFC 라이브러리를 정적으로 연결하는 스냅인에서 호출해서는 안 됩니다. 이러한 스냅인에 의한 이 함수 호출이 제대로 연결되지 않습니다.

CPropertyPage에서 파생된 각 페이지에 대해 다음 지침에 따라 페이지의 콜백에 대한 포인터를 사용하여 MMCPropPageCallback을 호출합니다.

  • 특정 속성 시트의 모든 페이지는 동일한 콜백 포인터를 사용해야 합니다.
  • MFC의 콜백을 사용자 고유의 콜백으로 바꾸는 경우 콜백은 MFC의 콜백을 호출해야 합니다.
  • CPropertyPage 파생 클래스를 사용하여 이 함수를 호출해야 합니다.
MFC는 내보낸 함수 또는 COM 인터페이스에서 올바른 모듈 상태를 설정해야 합니다. 여기에는 운영 체제에서 모듈로의 호출이 포함됩니다. 내보낸 함수 또는 COM 인터페이스의 경우 MFC에 동적으로 연결되는 스냅인 DLL에서 내보낸 모든 함수의 시작 부분에 AFX_MANAGE_STATE 매크로를 추가하여 이 작업을 수행합니다. 이 작업은 스냅인에서 내보낸 함수의 시작 부분에 다음 코드 줄을 추가하여 수행됩니다.
AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

운영 체제 호출의 경우 MFC는 이 작업을 자동으로 수행합니다. MMC의 속성 시트는 MFC CPropertySheet가 아니므로 콜백으로 인한 운영 체제 호출이 잘못된 모듈 상태입니다. 따라서 페이지를 만드는 동안 모듈 상태가 올바르게 설정되었는지 확인해야 합니다. 이는 MMCPropPageCallback의 목적입니다. 모듈 상태가 설정되면 스냅인에 의해 구현된 COM 인터페이스(예: IExtendPropertySheet2::CreatePropertyPages)에 의해 노출되는 호출만 AFX_MANAGE_STATE. 애플리케이션에 올바른 모듈 상태가 있는지 확인하려면 CWinApp 을 살펴보고 애플리케이션 이름을 확인합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 mmc.h

참고 항목

PROPSHEETPAGE