IResultData2：：RenameResultItem 方法 (mmc.h)

RenameResultItem 方法會以程序設計方式將指定的結果專案放入重新命名模式，之後，使用者可以手動輸入新名稱。這個方法專為建立專案且必須立即放入重新命名模式的情況而設計。不支援在其他情況下使用此方法，例如在選取項目之後呼叫，而且可能有非預期的結果。

語法

HRESULT RenameResultItem(
  [in] HRESULTITEM itemID
);

[in] itemID

要放入重新命名模式的結果專案。套用至虛擬清單時，請傳遞專案索引，而不是結果專案。

如果成功，則會S_OK傳回值;否則，傳回值是錯誤碼。 SUCCEEDED 和/或 FAILED 宏可用來評估傳回值。如果未啟用 Rename 動詞命令，這個方法會傳回E_FAIL。

進入重新命名模式的項目必須啟用 Rename 動詞命令，這個方法才能成功。