Método IPropertySheetProvider::Show (mmc.h)
Se o tipo que foi definido em IPropertySheetProvider::CreatePropertySheet for uma folha de propriedades, IPropertySheetProvider::Show exibirá um quadro de folha de propriedades que é pai de uma janela oculta. Se o tipo que foi definido em IPropertySheetProvider::CreatePropertySheet for um assistente, IPropertySheetProvider::Show exibirá um quadro de folha de propriedades com o identificador que é passado para esse método.
Sintaxe
HRESULT Show(
[in] LONG_PTR window,
[in] int page
);
Parâmetros
[in] window
Um valor que especifica o identificador para a janela pai.
[in] page
Um valor que especifica qual página na folha de propriedades é mostrada. Ele é indexado por zero.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
IPropertySheetProvider::Show( –1, 0) retorna E_FAIL. Esse código de retorno pode ser ignorado nesse caso.
Em situações em que o snap-in cria uma folha de propriedades em uma chamada para IPropertySheetProvider::CreatePropertySheet, opcionalmente chama IPropertySheetProvider::AddPrimaryPages e IPropertySheetProvider::AddExtensionPages e 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.
IPropertySheetProvider::Show( –1, 0) exclui apenas a folha de propriedades atual, ou seja, uma que foi criada, mas ainda não foi mostrada. Depois que uma folha de propriedades é mostrada, o snap-in não pode fechá-la programaticamente. Somente o usuário pode fechar uma folha de propriedades mostrada. Nesse caso, o MMC exclui automaticamente todas as páginas de propriedades associadas (estruturas PROPSHEETPAGE ) fornecidas pelo snap-in.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |