Metodo IExtendPropertySheet::CreatePropertyPages (mmc.h)

Articolo
08/24/2023

Aggiunge pagine a una finestra delle proprietà.

Sintassi

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

Parametri

[in] lpProvider

Puntatore all'interfaccia IPropertySheetCallback .

[in] handle

Valore che specifica l'handle usato per instradare il messaggio di notifica MMCN_PROPERTY_CHANGE all'interfaccia IComponent o IComponentData appropriata.

Per gli snap-in che usano direttamente l'interfaccia IPropertySheetProvider , MMC crea l'handle quando lo snap-in chiama IPropertySheetProvider::AddPrimaryPages e specifica il relativo bCreateHandle come TRUE.

[in] lpIDataObject

Puntatore all'interfaccia IDataObject nell'oggetto contenente informazioni di contesto sull'ambito o sull'elemento di risultato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

L'interfaccia IPropertySheetCallback viene passata allo snap-in durante una chiamata a questo metodo. La durata di questa interfaccia è sotto il controllo di MMC. Di conseguenza, il puntatore lpIDataObject è valido solo durante la durata della chiamata immediata a questo metodo. La memorizzazione nella cache del valore del puntatore lpIDataObject all'esterno del callback non è consigliata.

L'handle specificato dal parametro handle deve essere salvato nell'oggetto pagina delle proprietà per notificare all'elemento padre delle modifiche delle proprietà usando la funzione API MMCPropertyChangeNotify.

Se lo snap-in restituisce un codice di esito positivo (S_OK, S_FALSE) da CreatePropertyPages, lo snap-in deve chiamare MMCFreeNotifyHandle. Se lo snap-in restituisce un codice di errore, MMC libera immediatamente l'handle. Per altre informazioni su quando è necessario chiamare MMCFreeNotifyHandle, vedere MMCFreeNotifyHandle.