Метод IWEExtendPropertySheet::CreatePropertySheetPages (cluadmex.h)
Создает страницы свойств для объекта кластера и добавляет их в страницу свойств администратора отказоустойчивого кластера .
Синтаксис
HRESULT CreatePropertySheetPages(
[in] IUnknown *piData,
[in] IWCPropertySheetCallback *piCallback
);
Параметры
[in] piData
Указатель интерфейса IUnknown для получения сведений, связанных с новыми страницами свойств. При вызове метода IUnknown::QueryInterface с указателем piData доступны следующие интерфейсы:
В зависимости от типа объекта кластера , для которого создаются страницы страниц свойств, также доступен указатель на один из следующих интерфейсов:- IGetClusterNodeInfo, если страница свойств связана с узлом.
- IGetClusterGroupInfo, если страница свойств связана с группой.
- IGetClusterNetworkInfo, если страница свойств связана с сетью.
- IGetClusterNetInterfaceInfo, если страница свойств связана с сетевым интерфейсом.
- IGetClusterResourceInfo, если страница свойств связана с ресурсом.
[in] piCallback
Указатель на реализацию интерфейса IWCPropertySheetCallback для добавления страниц свойств в страницу свойств "Администратор кластера".
Возвращаемое значение
Возвращает одно из следующих значений или любое значение HRESULT , описывающее результаты операции.
| Возвращаемый код или значение | Описание |
|---|---|
|
Операция выполнена успешно. |
|
По крайней мере один из параметров является недопустимым. |
|
Расширение не поддерживает добавление страниц свойств. |
Комментарии
Администратор отказоустойчивого кластера вызывает метод CreatePropertySheetPages расширения, чтобы расширить лист свойств для обработки дополнительного объекта кластера.
Примечания для разработчиков
Для каждой добавляемой страницы свойств
- Используйте piData для вызова QueryInterface и получения указателя интерфейса для объекта кластера, связанного со страницей. Например, при добавлении страницы свойств для ресурса необходимо получить указатель на интерфейс IGetClusterResourceInfo . Хотя можно успешно запрашивать интерфейсы, извлекающие данные, не связанные с целевым объектом, при попытке вызова методов должны возникать ошибки.
-
Чтобы создать страницу, вызовите функцию CreatePropertySheetPage. Чтобы создавать страницы, похожие на страницы, предоставленные администратором кластера, каждая новая страница свойств должна быть не более 252 диалоговых единиц в ширину и 218 диалоговых единиц в высоту, а также должна содержать два стандартных элемента управления:
- Для значка объекта — значок, расположенный в (8,7) с размером (18,20).
- Для имени объекта — статический элемент управления, расположенный в (38,12) с размером (206,10).
- Чтобы добавить страницу на страницу свойств, вызовите метод IWCPropertySheetCallback::AddPropertySheetPage , на который указывает piCallback.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
| Целевая платформа | Windows |
| Header | cluadmex.h |