共用方式為

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

另請參閱

IStorage - 複合檔案實作