Méthode IResultData2 ::RenameResultItem (mmc.h)

La méthode RenameResultItem place par programmation l’élément de résultat spécifié en mode de renommage, après quoi l’utilisateur peut entrer manuellement le nouveau nom. Cette méthode est conçue spécifiquement pour le cas où un élément est créé et doit immédiatement être placé en mode renommage. L’utilisation de cette méthode dans d’autres scénarios, comme l’appel après la sélection d’un élément, n’est pas prise en charge et peut avoir des résultats inattendus.

Syntaxe

HRESULT RenameResultItem(
  [in] HRESULTITEM itemID
);

Paramètres

[in] itemID

Élément de résultat placé en mode de renommage. En cas d’application à des listes virtuelles, passez l’index d’élément au lieu de l’élément de résultat.

Valeur retournée

En cas de réussite, la valeur de retour est S_OK ; sinon, la valeur de retour est un code d’erreur. Les macros SUCCEEDED et/ou FAILED peuvent être utilisées pour évaluer la valeur de retour. Si le verbe Renommer n’est pas activé, cette méthode retourne E_FAIL.

Remarques

Pour que cette méthode réussisse, le verbe Renommer doit être activé pour que l’élément placé en mode de renommage soit activé.

Configuration requise

Voir aussi

IConsole3 ::RenameScopeItem