Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IResultData2::RenameResultItem method

The RenameResultItem method programmatically places the specified result item into rename mode, after which, the user can manually enter the new name. This method is designed specifically for the case where an item is created and immediately must be placed into rename mode. Use of this method under other scenarios, such as being called after an item has been selected, is not supported and may have unexpected results.

Syntax


HRESULT RenameResultItem(
  [in] HRESULTITEM itemID
);

Parameters

itemID [in]

The result item being placed into rename mode. When applied to virtual lists, pass the item index instead of the result item.

Return value

If successful, the return value is S_OK; otherwise, the return value is an error code. The SUCCEEDED and/or FAILED macros can be used to evaluate the return value. If the Rename verb is not enabled, this method returns E_FAIL.

Remarks

The item being placed into rename mode must have the Rename verb enabled for this method to succeed.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

Library

Mmc.lib

DLL

Mmcndmgr.dll

See also

IConsole3::RenameScopeItem

 

 

Show: