IPropertySheetProvider::Show 메서드(mmc.h)
IPropertySheetProvider::CreatePropertySheet에 설정된 형식이 속성 시트인 경우 IPropertySheetProvider::Show는 숨겨진 창에 부모로 설정된 속성 시트 프레임을 표시합니다. IPropertySheetProvider::CreatePropertySheet에 설정된 형식이 마법사인 경우 IPropertySheetProvider::Show는 이 메서드에 전달되는 핸들에 부모로 설정된 속성 시트 프레임을 표시합니다.
구문
HRESULT Show(
[in] LONG_PTR window,
[in] int page
);
매개 변수
[in] window
부모 창에 대한 핸들을 지정하는 값입니다.
[in] page
속성 시트에 표시되는 페이지를 지정하는 값입니다. 인덱싱되지 않습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
IPropertySheetProvider::Show( –1, 0)는E_FAIL 반환합니다. 이 경우 이 반환 코드를 무시할 수 있습니다.
스냅인에서 IPropertySheetProvider::CreatePropertySheet 호출에서 속성 시트를 만드는 경우 필요에 따라 IPropertySheetProvider::AddPrimaryPages 및 IPropertySheetProvider::AddExtensionPages를 호출한 다음 속성 시트를 표시하지 않기로 결정합니다. 속성 시트를 삭제하고 리소스를 해제하려면 IPropertySheetProvider::Show(–1, 0) 를 호출해야 합니다. 이 경우 스냅인은 만든 속성 페이지 핸들을 삭제해야 합니다. MMC는 속성 페이지 핸들을 사용하지 않으므로 스냅인에서 IPropertySheetProvider::Show(–1, 0)를 호출하기 전이나 후에 이 작업을 수행할 수 있습니다.
IPropertySheetProvider::Show( –1, 0) 는 현재 속성 시트,즉, 만든 시트만 삭제하지만 아직 표시되지 않습니다. 속성 시트가 표시되면 스냅인은 프로그래밍 방식으로 닫을 수 없습니다. 사용자만 표시되는 속성 시트를 닫을 수 있습니다. 이 경우 MMC는 스냅인에서 제공하는 모든 연결된 속성 페이지(PROPSHEETPAGE 구조)를 자동으로 삭제합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
지원되는 최소 서버 | Windows Server 2008 |
대상 플랫폼 | Windows |
헤더 | mmc.h |
DLL | Mmcndmgr.dll |