Método IPropertySheetCallback::AddPage (mmc.h)
O método IPropertySheetCallback::AddPage permite que um snap-in adicione uma página a uma folha de propriedades.
Sintaxe
HRESULT AddPage(
[in] HPROPSHEETPAGE hPage
);
Parâmetros
[in] hPage
Um valor que especifica o identificador para a página a ser adicionada. O parâmetro hPage é um identificador para uma estrutura PROPSHEETPAGE criada pela API do Windows CreatePropertySheetPage.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
O snap-in não pode chamar AddPage de dentro de um manipulador de página de propriedades porque a página de propriedades é criada e executada em um thread secundário. Um snap-in não pode chamar uma interface MMC de um thread diferente daquela em que o snap-in foi criado. O local correto para chamar AddPage está na implementação do snap-in do método IExtendPropertySheet2::CreatePropertyPages .
Se um snap-in usar a interface IPropertySheetProvider diretamente, ele poderá usar AddPage para adicionar as páginas primárias e, em seguida, chamar IPropertySheetProvider::AddPrimaryPages (NULL, FALSE, NULL, [TRUE ou FALSE]) para que o provedor adicione essas páginas à folha de propriedades. Para obter mais informações sobre como criar suas páginas de propriedades na implementação do snap-in de IExtendPropertySheet2::CreatePropertyPages, consulte IPropertySheetProvider::AddPrimaryPages.
As páginas são adicionadas à planilha na ordem em que são apresentadas. As páginas do snap-in primário são sempre adicionadas primeiro.
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 |