IVssComponentEx：：GetRestoreName 方法 (vswriter.h)

  • 發行項

取得指派給正在還原之元件的邏輯名稱。

語法

HRESULT GetRestoreName(
  [out] BSTR *pbstrName
);

參數

[out] pbstrName

呼叫端配置的變數位址，接收包含元件還原名稱的 Null 終止寬字元字串。

傳回值

以下是這個方法的有效傳回碼。

值 意義
S_OK
 作業成功。
E_INVALIDARG
 其中一個參數值無效。
E_OUTOFMEMORY
 呼叫端記憶體不足或其他系統資源。

備註

GetRestoreName 方法只能在還原作業期間呼叫。

如果呼叫 GetRestoreName 成功，呼叫端會負責藉由呼叫 SysFreeString 函式釋放 pbstrName 參數中傳回的字串。

寫入器會藉由在其備份架構掩碼中設定 VSS_BS_RESTORE_RENAME 旗標，來指出它支援此方法。

如需詳細資訊，請參閱 設定 VSS 還原選項。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 vswriter.h (包括 Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssBackupComponentsEx2：：SetRestoreName

IVssComponentEx

VSS_BACKUP_SCHEMA