Метод IPropertySheetCallback::AddPage (mmc.h)
Метод IPropertySheetCallback::AddPage позволяет оснастке добавлять страницу на страницу свойств.
Синтаксис
HRESULT AddPage(
[in] HPROPSHEETPAGE hPage
);
Параметры
[in] hPage
Значение типа , указывающее дескриптор добавляемой страницы. Параметр hPage — это дескриптор структуры PROPSHEETPAGE , созданной с помощью API Windows CreatePropertySheetPage.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Оснастка не может вызвать AddPage из обработчика страницы свойств, так как страница свойств создается и выполняется во вторичном потоке. Оснастка не может вызывать интерфейс MMC из потока, отличного от потока, в котором была создана оснастка. Правильное место для вызова AddPage находится в реализации оснастки метода IExtendPropertySheet2::CreatePropertyPages .
Если оснастка напрямую использует интерфейс IPropertySheetProvider, она может использовать AddPage для добавления первичных страниц, а затем вызвать IPropertySheetProvider::AddPrimaryPages (NULL, FALSE, NULL, [TRUE или FALSE]), чтобы поставщик добавил эти страницы на страницу свойств. Дополнительные сведения о создании страниц свойств в реализации оснастки IExtendPropertySheet2::CreatePropertyPages см. в разделе IPropertySheetProvider::AddPrimaryPages.
Страницы добавляются на лист в том порядке, в котором они представлены. Страницы основной оснастки всегда добавляются первыми.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |
| DLL | Mmcndmgr.dll |