Метод IWEExtendWizard::CreateWizardPages (cluadmex.h)

Статья
08/22/2023

[Этот метод доступен для использования в операционных системах, указанных в разделе Требования. Поддержка этого метода была удалена в Windows Server 2008.]

Позволяет создавать страницы мастера и добавлять их в мастер создания ресурсов администратора отказоустойчивого кластера или мастер кластерного приложения.

Синтаксис

HRESULT CreateWizardPages(
  [in] IUnknown          *piData,
  [in] IWCWizardCallback *piCallback
);

Параметры

[in] piData

Указатель интерфейса IUnknown для получения сведений, относящихся к добавляемой странице мастера. При вызове IUnknown::QueryInterface с указателем piData доступны следующие интерфейсы:

В зависимости от типа объекта кластера , для которого создается страница мастера, также доступен указатель на один из следующих интерфейсов:

IGetClusterNodeInfo, если страница свойств связана с узлом.
IGetClusterGroupInfo, если страница свойств связана с группой.
IGetClusterNetworkInfo, если страница свойств связана с сетью.
IGetClusterNetInterfaceInfo, если страница свойств связана с сетевым интерфейсом.
IGetClusterResourceInfo, если страница свойств связана с ресурсом.

[in] piCallback

Указатель на реализацию интерфейса IWCWizardCallback , которая используется для добавления новых страниц свойств в мастер.

Возвращаемое значение

Возвращает одно из следующих значений или любое значение HRESULT , описывающее результаты операции.

Возвращаемый код/значение	Описание
NOERROR 0	Операция выполнена успешно.
E_INVALIDARG 0x80070057	По крайней мере один из параметров является недопустимым.
E_NOTIMPL 0x80004001	Расширение не поддерживает добавление страницы свойств в мастер создания групп или мастер создания ресурсов.

Используйте piData для вызова QueryInterface и получения указателя интерфейса для объекта кластера , связанного с новой страницей. Например, если вы добавляете страницу свойств для ресурса, необходимо получить указатель на интерфейс IGetClusterResourceInfo . Хотя можно успешно запрашивать интерфейсы, извлекающие данные, не связанные с расширяемым объектом, при попытке вызова методов должны возникнуть ошибки.
Чтобы создать страницу, вызовите функцию CreatePropertySheetPage. Чтобы создавать страницы, похожие на страницы, предоставленные администратором кластера, каждая новая страница свойств должна быть не более 252 диалоговых единиц в ширину и 218 диалоговых единиц в высоту, а также должна содержать два стандартных элемента управления:
- Для значка объекта — элемент управления значок, расположенный в (8,7) с размером (18,20).
- Для имени объекта — статический элемент управления, расположенный в (38,12) с размером (247,10).
Чтобы добавить страницу в мастер администратора кластера, вызовите IWCWizardCallback::AddWizardPage с помощью указателя piCallback .

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 Корпоративная, Windows Server 2003 Datacenter
Целевая платформа	Windows
Header	cluadmex.h