IPropertySheetProvider::CreatePropertySheet 메서드(mmc.h)
IPropertySheetProvider::CreatePropertySheet 메서드는 속성 시트 프레임을 만듭니다.
구문
HRESULT CreatePropertySheet(
[in] LPCWSTR title,
[in] boolean type,
[in] MMC_COOKIE cookie,
[in] LPDATAOBJECT pIDataObjectm,
[in] DWORD dwOptions
);
매개 변수
[in] title
속성 페이지의 제목을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.
[in] type
TRUE 는 속성 시트를 만들고 FALSE 는 마법사를 만듭니다.
[in] cookie
현재 선택한 항목의 쿠키 값입니다. 확장 스냅인에서 CreatePropertySheet를 호출할 때 NULL 일 수 있습니다.
[in] pIDataObjectm
쿠키에 대한 데이터 개체의 IDataObject 인터페이스에 대한 포인터입니다. 이 매개 변수의 값이 NULL인 경우 MMC는 확장 스냅인에 의해 구현된 IExtendPropertySheet2 메서드를 호출하지 않습니다.
[in] dwOptions
메서드 호출에서 설정할 수 있는 플래그를 지정하는 값입니다. 매개 변수는 다음 값의 조합일 수 있습니다.
MMC_PSO_NOAPPLYNOW
지금 적용 단추를 제거합니다.
MMC_PSO_HASHELP
도움말 단추를 추가합니다.
MMC_PSO_NO_PROPTITLE
마법사에 대해 무시됩니다. 속성 시트의 경우 이 옵션을 지정하면 속성 시트 제목 표시줄의 시작 부분에 "Properties for"라는 단어가 삽입되지 않습니다.
MMC_PSO_NEWWIZARDTYPE
마법사 97 스타일을 사용합니다.
예를 들어 도움말 단추가 있고 지금 적용 단추가 없는 속성 시트를 만들려면 dwOptions 매개 변수는 이어야 MMC_PSO_NOAPPLYNOW | MMC_PSO_HASHELP합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
이 메서드는 속성 시트를 만드는 데 필요한 모든 정보를 수집하는 개체를 만듭니다. CreatePropertySheet 호출에 성공했지만 후속 오류가 발생하는 경우 IPropertySheetProvider::Show( –1, 0)를 호출하여 개체를 해제해야 합니다. 이 경우 반환 코드를 무시할 수 있습니다.
스냅인에서 IPropertySheetProvider::CreatePropertySheet 호출에서 속성 시트를 만든 다음 선택적으로 IPropertySheetProvider::AddPrimaryPages 및 IPropertySheetProvider::AddExtensionPages를 호출하는 경우 속성 시트를 표시하지 않기로 결정하면 IPropertySheetProvider::Show( –1, 0)를 호출하여 속성 시트를 삭제하고 해당 리소스를 해제해야 합니다. 이 경우 스냅인은 만든 속성 페이지 핸들을 삭제해야 합니다. MMC는 속성 페이지 핸들을 사용하지 않으므로 스냅인에서 IPropertySheetProvider::Show(–1, 0)를 호출하기 전이나 후에 이 작업을 수행할 수 있습니다.
MMC 1.1을 대상으로 하는 스냅인의 경우 스냅인은 IPropertySheetProvider::CreatePropertySheet 호출에서 MMC에 전달하는 IDataObject 인터페이스에 대한 추가 참조를 유지해야 합니다. 이 참조는 IPropertySheetProvider::CreatePropertySheet 호출 이전부터 IPropertySheetProvider::Show( –1, 0)를 호출하여 속성 시트를 닫을 때까지 유지해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |
| DLL | Mmcndmgr.dll |