Metodo IExtendTaskPad::TaskNotify (mmc.h)
Il metodo IExtendTaskPad::TaskNotify consente a MMC di notificare lo snap-in quando un'attività viene estesa. Se il blocco attività è un taskpad di visualizzazione elenco, MMC chiama anche IExtendTaskPad::TaskNotify quando viene esteso un pulsante di visualizzazione elenco.
Sintassi
HRESULT TaskNotify(
[in] IDataObject *pdo,
[in] VARIANT *arg,
[in] VARIANT *param
);
Parametri
[in] pdo
Puntatore all'oggetto dati per l'elemento dell'ambito proprietario del blocco attività. Se lo snap-in possiede l'elemento che visualizza il blocco attività, pdo è un puntatore a tale elemento. Se lo snap-in estende il blocco attività di un altro snap-in, pdo è un puntatore all'elemento nello snap-in che possiede il blocco attività.
[in] arg
Puntatore a una struttura VARIANT che contiene informazioni passate dal controllo CIC nel blocco attività.
Taskpad con modelli di taskpad MMC
Per i blocchi attività forniti da MMC, la struttura VARIANT contiene l'ID comando per l'attività del blocco attività o il pulsante di visualizzazione elenco che è stato ed.
Il campo vt è VT_I4 e il campo lVal contiene l'ID comando per l'attività del blocco attività o il pulsante di visualizzazione elenco che è stato ed. I pulsanti di visualizzazione elenco si applicano solo ai blocchi attività di visualizzazione elenco.
Un ID comando dell'attività viene specificato nel membro nCommandID della struttura MMC_TASK , passato nel metodo IEnumTASK::Next che mmC chiama quando recupera le informazioni per tale attività durante la configurazione del blocco attività.
Un pulsante di visualizzazione elenco è il pulsante specificato nel membro szButtonText della struttura MMC_LISTPAD_INFO , passato nel metodo IExtendTaskPad::GetListPadInfo che viene chiamato da MMC durante la configurazione del blocco attività di visualizzazione elenco. L'ID comando del pulsante di visualizzazione elenco viene specificato nel membro nCommandID di MMC_LISTPAD_INFO.
Blocchi attività usando pagine HTML personalizzate
Per i taskpad personalizzati, la struttura VARIANT può contenere tutti i dati che lo script nella pagina HTML personalizzata vuole passare attraverso il metodo TaskNotify dell'oggetto CIC
[in] param
Puntatore a una struttura VARIANT che contiene informazioni passate dal controllo CIC nel blocco attività.
I blocchi attività che usano i modelli del blocco attività MMC ignorano questo parametro. Tuttavia, i blocchi attività personalizzati possono usarli per passare un valore aggiuntivo allo snap-in.
Valore restituito
Questo metodo può restituire uno di questi valori.
Commenti
Lo snap-in può identificare l'elemento dell'ambito proprietario del blocco attività usando il puntatore pdo; può quindi identificare l'attività dal valore VARIANT restituito nel parametro arg. Se il blocco attività è un blocco attività di visualizzazione elenco, lo snap-in può identificare l'elemento selezionato (o gli elementi se è supportata la selezione multipla) in un elenco risultati usando l'interfaccia IResultData . In base a questi dati, lo snap-in può eseguire le azioni appropriate sull'oggetto appropriato.
Se per un blocco attività viene eseguito un pulsante di visualizzazione elenco per un blocco attività di visualizzazione elenco, lo snap-in può identificare il pulsante per il blocco attività specifico dal valore VARIANT restituito nel parametro arg.
Un taskpad personalizzato può passare tutti i valori che determina devono essere inviati nei parametri arg e param.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |