Метод IResultData2::RenameResultItem (mmc.h)
Метод RenameResultItem программно переводит указанный результирующий элемент в режим переименования, после чего пользователь может вручную ввести новое имя. Этот метод предназначен специально для случая, когда элемент создается и немедленно должен быть переведен в режим переименования. Использование этого метода в других сценариях, таких как вызов после выбора элемента, не поддерживается и может привести к непредвиденным результатам.
Синтаксис
HRESULT RenameResultItem(
[in] HRESULTITEM itemID
);
Параметры
[in] itemID
Результирующий элемент, помещенный в режим переименования. При применении к виртуальным спискам передайте индекс элемента вместо элемента результата.
Возвращаемое значение
В случае успешного выполнения возвращаемое значение будет S_OK; В противном случае возвращаемое значение является кодом ошибки. Макросы SUCCEEDED и/или FAILED можно использовать для оценки возвращаемого значения. Если команда Переименовать не включена, этот метод возвращает E_FAIL.
Комментарии
Для успешного выполнения этого метода для элемента, помещаемого в режим переименования, должна быть включена команда Переименовать.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |
| Библиотека | Mmc.lib |
| DLL | Mmcndmgr.dll |