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

El método RenameResultItem coloca mediante programación el elemento de resultado especificado en modo de cambio de nombre, después de lo cual el usuario puede escribir manualmente el nuevo nombre. Este método está diseñado específicamente para el caso en el que se crea un elemento y debe colocarse inmediatamente en el modo de cambio de nombre. El uso de este método en otros escenarios, como llamar a después de seleccionar un elemento, no se admite y puede tener resultados inesperados.

Sintaxis

HRESULT RenameResultItem(
  [in] HRESULTITEM itemID
);

Parámetros

[in] itemID

Elemento de resultado que se coloca en modo de cambio de nombre. Cuando se aplica a las listas virtuales, pase el índice de elemento en lugar del elemento de resultado.

Valor devuelto

Si se ejecuta correctamente, el valor devuelto es S_OK; de lo contrario, el valor devuelto es un código de error. Las macros SUCCEEDED o FAILED se pueden usar para evaluar el valor devuelto. Si el verbo Cambiar nombre no está habilitado, este método devuelve E_FAIL.

Comentarios

El elemento que se coloca en modo de cambio de nombre debe tener habilitado el verbo Cambiar nombre para que este método se realice correctamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	mmc.h
Library	Mmc.lib
Archivo DLL	Mmcndmgr.dll

Consulte también

IConsole3::RenameScopeItem