IVssComponentEx::GetRestoreName 方法 (vswriter.h)
取得指派給正在還原之元件的邏輯名稱。
語法
HRESULT GetRestoreName(
[out] BSTR *pbstrName
);
參數
[out] pbstrName
呼叫端配置的變數位址,接收包含元件還原名稱的 Null 終止寬字元字串。
傳回值
以下是這個方法的有效傳回碼。
值 | 意義 |
---|---|
|
作業成功。 |
|
其中一個參數值無效。 |
|
呼叫端記憶體不足或其他系統資源。 |
備註
GetRestoreName 方法只能在還原作業期間呼叫。
如果呼叫 GetRestoreName 成功,呼叫端會負責藉由呼叫 SysFreeString 函式釋放 pbstrName 參數中傳回的字串。
寫入器會藉由在其備份架構掩碼中設定 VSS_BS_RESTORE_RENAME 旗標,來指出它支援此方法。
如需詳細資訊,請參閱 設定 VSS 還原選項。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | vswriter.h (包括 Vss.h、VsWriter.h) |
程式庫 | VssApi.lib |