Méthode IResultData::InsertItem (mmc.h)

La méthode IResultData::InsertItem permet au composant logiciel enfichable d’ajouter un seul nouvel élément à l’affichage du volet de résultats.

Syntaxe

HRESULT InsertItem(
  [in, out] LPRESULTDATAITEM item
);

Paramètres

[in, out] item

Pointeur vers une structure RESULTDATAITEM qui contient des informations sur l’élément à ajouter.

Une fois l’élément inséré, un identificateur unique (un ID d’élément) lui est attribué par MMC et retourné via le membre itemID de la structure pointée par le paramètre item. N’oubliez pas que la valeur itemID est le handle HRESULTITEM de l’élément inséré. Le composant logiciel enfichable doit stocker cette valeur afin de manipuler ultérieurement l’élément inséré en appelant des méthodes telles que IResultData::GetItem.

Si cet identificateur n’est pas stocké, vous pouvez le rechercher à l’aide de IResultData::FindItemByLParam.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Le masque et tous les champs associés appropriés dans la structure RESULTDATAITEM doivent être renseignés. Les sous-éléments ne peuvent pas être insérés, mais peuvent être définis. Le membre nCol de la structure d’élément doit donc être égal à zéro.

Le membre str de RESULTDATAITEM doit être défini sur MMC_CALLBACK.

Une fois l’élément inséré, un identificateur unique (un ID d’élément) lui est attribué par MMC et retourné via le membre itemID de la structure pointée par le paramètre item. N’oubliez pas que la valeur itemID est le handle HRESULTITEM de l’élément inséré. Le composant logiciel enfichable doit stocker cette valeur afin de manipuler ultérieurement l’élément inséré en appelant des méthodes telles que IResultData::GetItem.

Si cet identificateur n’est pas stocké, il peut être identifié à l’aide de IResultData::FindItemByLParam.

Cette méthode ne prend pas en charge les listes virtuelles.

Spécifications

Voir aussi

IResultData

IResultData2