IResultData2::RenameResultItem メソッド (mmc.h)
RenameResultItem メソッドは、指定した結果項目をプログラムによって名前変更モードに設定し、その後、ユーザーは手動で新しい名前を入力できます。 このメソッドは、項目が作成され、直ちに名前変更モードにする必要がある場合に特化して設計されています。 項目の選択後に呼び出されるなど、他のシナリオでのこのメソッドの使用はサポートされていないため、予期しない結果が発生する可能性があります。
構文
HRESULT RenameResultItem(
[in] HRESULTITEM itemID
);
パラメーター
[in] itemID
名前変更モードに配置される結果アイテム。 仮想リストに適用する場合は、結果項目ではなく項目インデックスを渡します。
戻り値
成功した場合、戻り値はS_OK。それ以外の場合、戻り値はエラー コードです。 SUCCEEDED マクロまたは FAILED マクロを使用して、戻り値を評価できます。 Rename 動詞が有効になっていない場合、このメソッドはE_FAILを返します。
注釈
このメソッドを正常に実行するには、名前変更モードのアイテムに Rename 動詞が有効になっている必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |
| Library | Mmc.lib |
| [DLL] | Mmcndmgr.dll |