Método IPropertySheetProvider::CreatePropertySheet (mmc.h)
El método IPropertySheetProvider::CreatePropertySheet crea un marco de hoja de propiedades.
Sintaxis
HRESULT CreatePropertySheet(
[in] LPCWSTR title,
[in] boolean type,
[in] MMC_COOKIE cookie,
[in] LPDATAOBJECT pIDataObjectm,
[in] DWORD dwOptions
);
Parámetros
[in] title
Puntero a una cadena terminada en null que contiene el título de la página de propiedades. Este parámetro no puede ser NULL.
[in] type
TRUE crea una hoja de propiedades y FALSE crea un asistente.
[in] cookie
Valor de cookie del elemento seleccionado actualmente. Esto puede ser NULL cuando un complemento de extensión llama a CreatePropertySheet.
[in] pIDataObjectm
Puntero a la interfaz IDataObject del objeto de datos de la cookie. Si el valor de este parámetro es NULL, MMC no llamará a ninguno de los métodos IExtendPropertySheet2 implementados por complementos de extensión.
[in] dwOptions
Valor que especifica las marcas que la llamada al método puede establecer. El parámetro puede ser una combinación de los valores siguientes:
MMC_PSO_NOAPPLYNOW
Quite el botón Aplicar ahora.
MMC_PSO_HASHELP
Agregue un botón Ayuda .
MMC_PSO_NO_PROPTITLE
Se omite para los asistentes. En el caso de las hojas de propiedades, si se especifica esta opción, las palabras "Propiedades para" no se insertarán al principio de la barra de título de la hoja de propiedades.
MMC_PSO_NEWWIZARDTYPE
Use el estilo del Asistente 97.
Por ejemplo, para crear una hoja de propiedades que tenga un botón Ayuda y que no tenga un botón Aplicar ahora, el parámetro dwOptions debe ser MMC_PSO_NOAPPLYNOW | MMC_PSO_HASHELP.
Valor devuelto
Este método puede devolver uno de estos valores.
Comentarios
Este método crea un objeto que recopila toda la información necesaria para crear una hoja de propiedades. Si la llamada a CreatePropertySheet se realiza correctamente, pero se producen errores posteriores, debe llamar a IPropertySheetProvider::Show( –1, 0) para liberar objetos. El código de retorno se puede omitir en este caso.
En situaciones en las que el complemento crea una hoja de propiedades en una llamada a IPropertySheetProvider::CreatePropertySheet y, opcionalmente, llama a IPropertySheetProvider::AddPrimaryPages e IPropertySheetProvider::AddExtensionPages, y, a continuación, decide no mostrar la hoja de propiedades, debe llamar a IPropertySheetProvider::Show( –1, 0) para eliminar la hoja de propiedades y liberar sus recursos. En este caso, el complemento debe eliminar los identificadores de la página de propiedades que ha creado. Esto se puede hacer antes o después de que el complemento llame a IPropertySheetProvider::Show( –1, 0), porque MMC no usa los identificadores de la página de propiedades.
Para un complemento destinado a MMC 1.1, el complemento debe mantener una referencia adicional en la interfaz IDataObject que pasa a MMC en la llamada a IPropertySheetProvider::CreatePropertySheet . Esta referencia debe mantenerse antes de la llamada A IPropertySheetProvider::CreatePropertySheet hasta que la hoja de propiedades se cierre posiblemente con una llamada a IPropertySheetProvider::Show( –1, 0).
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |
| Archivo DLL | Mmcndmgr.dll |