Метод IExtendPropertySheet::CreatePropertyPages (mmc.h)
Добавляет страницы в лист свойств.
Синтаксис
HRESULT CreatePropertyPages(
[in] LPPROPERTYSHEETCALLBACK lpProvider,
[in] LONG_PTR handle,
[in] LPDATAOBJECT lpIDataObject
);
Параметры
[in] lpProvider
Указатель на интерфейс IPropertySheetCallback .
[in] handle
Значение типа , указывающее дескриптор, используемый для маршрутизации сообщения уведомления MMCN_PROPERTY_CHANGE в соответствующий интерфейс IComponent или IComponentData .
Для оснастки, которые напрямую используют интерфейс IPropertySheetProvider , MMC создает дескриптор, когда оснастка вызывает IPropertySheetProvider::AddPrimaryPages и указывает для параметра bCreateHandle значение TRUE.
[in] lpIDataObject
Указатель на интерфейс IDataObject объекта , содержащий контекстные сведения о область или результирующем элементе.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Интерфейс IPropertySheetCallback передается оснастке во время вызова этого метода. Время существования этого интерфейса находится под контролем MMC. Таким образом, указатель lpIDataObject действителен только в течение времени существования немедленного вызова этого метода. Кэширование значения указателя lpIDataObject вне обратного вызова не рекомендуется.
Дескриптор, заданный параметром handle, должен быть сохранен в объекте страницы свойств, чтобы уведомить родителя об изменениях свойств с помощью функции API MMCPropertyChangeNotify.
Если оснастка возвращает код успешного выполнения (S_OK, S_FALSE) из CreatePropertyPages, оснастка должна вызвать MMCFreeNotifyHandle. Если оснастка возвращает код ошибки, MMC немедленно освобождает дескриптор. Дополнительные сведения о том, когда следует вызывать MMCFreeNotifyHandle, см. в разделе MMCFreeNotifyHandle.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |