Método IPropertySheetProvider::CreatePropertySheet (mmc.h)
O método IPropertySheetProvider::CreatePropertySheet cria um quadro de folha de propriedades.
Sintaxe
HRESULT CreatePropertySheet(
[in] LPCWSTR title,
[in] boolean type,
[in] MMC_COOKIE cookie,
[in] LPDATAOBJECT pIDataObjectm,
[in] DWORD dwOptions
);
Parâmetros
[in] title
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o título da página de propriedades. Esse parâmetro não pode ser NULL.
[in] type
TRUE cria uma folha de propriedades e FALSE cria um assistente.
[in] cookie
Valor do cookie do item selecionado no momento. Isso pode ser NULL quando CreatePropertySheet é chamado por um snap-in de extensão.
[in] pIDataObjectm
Um ponteiro para a interface IDataObject no objeto de dados do cookie. Se o valor desse parâmetro for NULL, o MMC não chamará nenhum dos métodos IExtendPropertySheet2 implementados por snap-ins de extensão.
[in] dwOptions
Um valor que especifica os sinalizadores que podem ser definidos pela chamada de método. O parâmetro pode ser uma combinação dos seguintes valores:
MMC_PSO_NOAPPLYNOW
Botão Remover Aplicar Agora.
MMC_PSO_HASHELP
Adicionar um botão Ajuda .
MMC_PSO_NO_PROPTITLE
Ignorado para assistentes. Para folhas de propriedades, se essa opção for especificada, as palavras "Propriedades para" não serão inseridas no início da barra de título da folha de propriedades.
MMC_PSO_NEWWIZARDTYPE
Use o estilo do Assistente 97.
Por exemplo, para criar uma folha de propriedades que tenha um botão Ajuda e que não tenha um botão Aplicar Agora, o parâmetro dwOptions deve ser MMC_PSO_NOAPPLYNOW | MMC_PSO_HASHELP.
Valor retornado
Esse método pode retornar um desses valores.
Comentários
Esse método cria um objeto que coleta todas as informações necessárias para criar uma folha de propriedades. Se a chamada createPropertySheet for bem-sucedida, mas ocorrerem erros subsequentes, você deverá chamar IPropertySheetProvider::Show( –1, 0) para liberar objetos. Nesse caso, o código de retorno pode ser ignorado.
Em situações em que o snap-in cria uma folha de propriedades em uma chamada para IPropertySheetProvider::CreatePropertySheet e, opcionalmente, chama IPropertySheetProvider::AddPrimaryPages e IPropertySheetProvider::AddExtensionPages, e, em seguida, decide não mostrar a folha de propriedades, ela deve chamar IPropertySheetProvider::Show( –1, 0) para excluir a folha de propriedades e liberar seus recursos. Nesse caso, o snap-in deve excluir os identificadores de página de propriedades que ele criou. Isso pode ser feito antes ou depois que o snap-in chama IPropertySheetProvider::Show( –1, 0), porque o MMC não usa os identificadores de página de propriedades.
Para um snap-in direcionado ao MMC 1.1, o snap-in deve manter uma referência extra na interface IDataObject que ele passa para o MMC na chamada IPropertySheetProvider::CreatePropertySheet . Essa referência deve ser mantida antes da chamada IPropertySheetProvider::CreatePropertySheet até que a folha de propriedades seja possivelmente fechada com uma chamada para IPropertySheetProvider::Show( –1, 0).
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |