Método IExtendPropertySheet::CreatePropertyPages (mmc.h)

Artigo
08/24/2023

Adiciona páginas a uma folha de propriedades.

Sintaxe

HRESULT CreatePropertyPages(
  [in] LPPROPERTYSHEETCALLBACK lpProvider,
  [in] LONG_PTR                handle,
  [in] LPDATAOBJECT            lpIDataObject
);

Parâmetros

[in] lpProvider

Um ponteiro para a interface IPropertySheetCallback .

[in] handle

Um valor que especifica o identificador usado para rotear a mensagem de notificação MMCN_PROPERTY_CHANGE para a interface IComponent ou IComponentData apropriada.

Para snap-ins que usam a interface IPropertySheetProvider diretamente, o MMC cria o identificador quando o snap-in chama IPropertySheetProvider::AddPrimaryPages e especifica seu bCreateHandle como TRUE.

[in] lpIDataObject

Um ponteiro para a interface IDataObject no objeto que contém informações de contexto sobre o escopo ou item de resultado.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

A interface IPropertySheetCallback é passada para o snap-in durante uma chamada para esse método. O tempo de vida dessa interface está sob o controle do MMC. Dessa forma, o ponteiro lpIDataObject é válido somente durante o tempo de vida da chamada imediata para esse método. Não é recomendável armazenar em cache o valor do ponteiro lpIDataObject fora do retorno de chamada.

O identificador especificado pelo parâmetro handle deve ser salvo no objeto de página de propriedades para notificar o pai das alterações de propriedade usando a função de API MMCPropertyChangeNotify.

Se o snap-in retornar um código de êxito (S_OK, S_FALSE) de CreatePropertyPages, o snap-in deverá chamar MMCFreeNotifyHandle. Se o snap-in retornar um código de erro, o MMC liberará imediatamente o identificador. Para obter mais informações sobre quando MMCFreeNotifyHandle deve ser chamado, consulte MMCFreeNotifyHandle.