Metodo IResultData::InsertItem (mmc.h)
Il metodo IResultData::InsertItem consente allo snap-in di aggiungere un singolo elemento alla visualizzazione del riquadro dei risultati.
Sintassi
HRESULT InsertItem(
[in, out] LPRESULTDATAITEM item
);
Parametri
[in, out] item
Puntatore a una struttura RESULTDATAITEM che contiene informazioni sull'elemento da aggiungere.
Dopo l'inserimento dell'elemento, viene assegnato un identificatore univoco (ID elemento) da MMC e restituito tramite il membro itemID della struttura a cui fa riferimento il parametro item. Tenere presente che il valore itemID è l'handle HRESULTITEM dell'elemento inserito. Lo snap-in deve archiviare questo valore per modificare in seguito l'elemento inserito chiamando metodi come IResultData::GetItem.
Se questo identificatore non è archiviato, può essere cercato usando IResultData::FindItemByLParam.
Valore restituito
Questo metodo può restituire uno di questi valori.
Commenti
La maschera e tutti i campi associati appropriati nella struttura RESULTDATAITEM devono essere compilati. Gli elementi secondari non possono essere inseriti ma possono essere impostati. Il membro nCol della struttura dell'elemento deve pertanto essere zero.
Il membro str di RESULTDATAITEM deve essere impostato su MMC_CALLBACK.
Dopo l'inserimento dell'elemento, viene assegnato un identificatore univoco (ID elemento) da MMC e restituito tramite il membro itemID della struttura a cui fa riferimento il parametro item. Tenere presente che il valore itemID è l'handle HRESULTITEM dell'elemento inserito. Lo snap-in deve archiviare questo valore per modificare in seguito l'elemento inserito chiamando metodi come IResultData::GetItem.
Se questo identificatore non è archiviato, può essere identificato usando IResultData::FindItemByLParam.
Questo metodo non supporta elenchi virtuali.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |
| DLL | Mmcndmgr.dll |