IExtendPropertySheet::CreatePropertyPages 메서드(mmc.h)

아티클
08/24/2023

속성 시트에 페이지를 추가합니다.

구문

HRESULT CreatePropertyPages(
  [in] LPPROPERTYSHEETCALLBACK lpProvider,
  [in] LONG_PTR                handle,
  [in] LPDATAOBJECT            lpIDataObject
);

매개 변수

[in] lpProvider

IPropertySheetCallback 인터페이스에 대한 포인터입니다.

[in] handle

MMCN_PROPERTY_CHANGE 알림 메시지를 적절한 IComponent 또는 IComponentData 인터페이스로 라우팅하는 데 사용되는 핸들을 지정하는 값입니다.

IPropertySheetProvider 인터페이스를 직접 사용하는 스냅인의 경우 스냅인이 IPropertySheetProvider::AddPrimaryPages를 호출할 때 MMC가 핸들을 만들고 해당 bCreateHandle을 TRUE로 지정합니다.

[in] lpIDataObject

scope 또는 결과 항목에 대한 컨텍스트 정보를 포함하는 개체의 IDataObject 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

IPropertySheetCallback 인터페이스는 이 메서드를 호출하는 동안 스냅인에 전달됩니다. 이 인터페이스의 수명은 MMC의 제어를 받습니다. 따라서 포인터 lpIDataObject는 이 메서드에 대한 직접 호출의 수명 동안에만 유효합니다. 콜백 외부에서 lpIDataObject 포인터 값을 캐싱하지 않는 것이 좋습니다.

API 함수 MMCPropertyChangeNotify를 사용하여 속성 변경 내용을 부모에 알리려면 handle 매개 변수로 지정된 핸들을 속성 페이지 개체에 저장해야 합니다.

스냅인이 CreatePropertyPages에서 성공 코드(S_OK, S_FALSE)를 반환하는 경우 스냅인은 MMCFreeNotifyHandle을 호출해야 합니다. 스냅인에서 오류 코드를 반환하면 MMC는 핸들을 즉시 해제합니다. MMCFreeNotifyHandle을 호출해야 하는 시기에 대한 자세한 내용은 MMCFreeNotifyHandle을 참조하세요.