Método IResultData2::RenameResultItem (mmc.h)
O método RenameResultItem coloca programaticamente o item de resultado especificado no modo de renomeação, após o qual o usuário pode inserir manualmente o novo nome. Esse método foi projetado especificamente para o caso em que um item é criado e imediatamente deve ser colocado no modo de renomeação. O uso desse método em outros cenários, como ser chamado após a seleção de um item, não tem suporte e pode ter resultados inesperados.
Sintaxe
HRESULT RenameResultItem(
[in] HRESULTITEM itemID
);
Parâmetros
[in] itemID
O item de resultado que está sendo colocado no modo de renomeação. Quando aplicado a listas virtuais, passe o índice de item em vez do item de resultado.
Retornar valor
Se tiver êxito, o valor retornado será S_OK; caso contrário, o valor retornado é um código de erro. As macros SUCCEEDED e/ou FAILED podem ser usadas para avaliar o valor retornado. Se o verbo Renomear não estiver habilitado, esse método retornará E_FAIL.
Comentários
O item que está sendo colocado no modo de renomeação deve ter o verbo Renomear habilitado para que esse método tenha êxito.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| Biblioteca | Mmc.lib |
| DLL | Mmcndmgr.dll |