Método IWEExtendPropertySheet::CreatePropertySheetPages (cluadmex.h)
Crea páginas de propiedades para un objeto de clúster y las agrega a una hoja de propiedades Administrador de clústeres de conmutación por error.
Sintaxis
HRESULT CreatePropertySheetPages(
[in] IUnknown *piData,
[in] IWCPropertySheetCallback *piCallback
);
Parámetros
[in] piData
Puntero de interfaz IUnknown para recuperar información relacionada con las nuevas páginas de propiedades. Al llamar al método IUnknown::QueryInterface con el puntero piData , están disponibles las siguientes interfaces:
Dependiendo del tipo de objeto de clúster para el que se crean páginas de hoja de propiedades, también hay disponible un puntero a una de las interfaces siguientes:- IGetClusterNodeInfo, si la página de propiedades está relacionada con un nodo.
- IGetClusterGroupInfo, si la página de propiedades está relacionada con un grupo.
- IGetClusterNetworkInfo, si la página de propiedades está relacionada con una red.
- IGetClusterNetInterfaceInfo, si la página de propiedades está relacionada con una interfaz de red.
- IGetClusterResourceInfo, si la página de propiedades está relacionada con un recurso.
[in] piCallback
Puntero a una implementación de la interfaz IWCPropertySheetCallback para agregar páginas de propiedades a la hoja de propiedades Administrador de clústeres.
Valor devuelto
Devuelve uno de los siguientes valores o cualquier HRESULT que describa los resultados de la operación.
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
Al menos uno de los parámetros no es válido. |
|
La extensión no admite la adición de páginas de propiedades. |
Comentarios
El administrador de clústeres de conmutación por error llama al método CreatePropertySheetPages de una extensión para extender una hoja de propiedades para controlar un objeto de clúster adicional.
Notas para los implementadores
Para cada página de propiedades que se va a agregar
- Use piData para llamar a QueryInterface y recuperar un puntero de interfaz para el objeto de clúster asociado a la página. Por ejemplo, si va a agregar una página de propiedades para un recurso, quiere recuperar un puntero a la interfaz IGetClusterResourceInfo . Aunque es posible consultar correctamente las interfaces que recuperan datos no relacionados con el objeto de destino, debe esperar recibir errores al intentar llamar a los métodos.
-
Para crear la página, llame a la función CreatePropertySheetPage. Para generar páginas que parecen las páginas proporcionadas por el administrador de clústeres, cada nueva página de propiedades no debe tener más de 252 unidades de diálogo de ancho y 218 unidades de diálogo altas, y debe contener dos controles estándar:
- Para el icono de objeto, un control de icono situado en (8,7) con un tamaño de (18,20).
- Para el nombre del objeto, un control estático situado en (38 12) con un tamaño de (206 10).
- Para agregar la página a la hoja de propiedades, llame al método IWCPropertySheetCallback::AddPropertySheetPage al que apunta piCallback.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Plataforma de destino | Windows |
| Encabezado | cluadmex.h |