IStorage：：RenameElement 方法 (objidl.h)
RenameElement 方法會重新命名這個記憶體物件中指定的子記憶體或數據流。
語法
HRESULT RenameElement(
[in] const OLECHAR *pwcsOldName,
[in] const OLECHAR *pwcsNewName
);
參數
[in] pwcsOldName
寬字元 Null 終止的 Unicode 字串指標，其中包含要變更之子記憶體或數據流的名稱。
注意在 CreateStorage 或 CreateStream 中建立的 pwcsName 長度不得超過 31 個字元，不包括字串終止符。
[in] pwcsNewName
寬字元 Null 終止 Unicode 字串的指標，其中包含指定之子記憶體或數據流的新名稱。
注意在 CreateStorage 或 CreateStream 中建立的 pwcsName 長度不得超過 31 個字元，不包括字串終止符。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
| S_OK | 已成功重新命名專案。 |
| E_PENDING | 僅限異步記憶體：目前無法使用部分或所有元素的數據。 |
| STG_E_ACCESSDENIED | 呼叫端沒有足夠的許可權可重新命名專案。 |
| STG_E_FILENOTFOUND | 具有指定舊名稱的專案不存在。 |
| STG_E_FILEALREADYEXISTS | 新名稱所指定的項目已經存在。 |
| STG_E_INSUFFICIENTMEMORY | 元素因為記憶體不足而未重新命名。 |
| STG_E_INVALIDNAME | 其中一個名稱的值無效。 |
| STG_E_INVALIDPOINTER | 為專案指定的指標無效。 |
| STG_E_INVALIDPARAMETER | 其中一個參數無效。 |
| STG_E_REVERTED | 記憶體物件已因交易樹狀結構中上方的還原作業而失效。 |
| STG_E_TOOMANYOPENFILES | 專案未重新命名，因為有太多開啟的檔案。 |
備註
IStorage：：RenameElement 會重新命名此記憶體物件中指定的子記憶體或數據流。 記憶體物件中的項目在開啟時無法重新命名。 如果記憶體以交易模式開啟，重新命名作業可能會認可變更。
IStorage：：RenameElement 方法不保證可在低記憶體中運作，且記憶體物件以交易模式開啟。 它可以在直接模式中運作。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | objidl.h |
| 程式庫 | Uuid.lib |
| Dll | Ole32.dll |