共用方式為


IVssBackupComponents::ExposeSnapshot 方法 (vsbackup.h)

ExposeSnapshot 方法會將陰影複製公開為驅動器號、掛接的資料夾或檔案共用。

語法

HRESULT ExposeSnapshot(
  [in]  VSS_ID   SnapshotId,
  [in]  VSS_PWSZ wszPathFromRoot,
  [in]  LONG     lAttributes,
  [in]  VSS_PWSZ wszExpose,
  [out] VSS_PWSZ *pwszExposed
);

參數

[in] SnapshotId

陰影複製標識碼。

[in] wszPathFromRoot

將陰影複製公開為檔案共享時,可供使用之磁碟區部分的路徑。 在本機公開陰影複製時,此參數的值必須是 NULL ;也就是說,將它公開為驅動器號或掛接的資料夾。

路徑不能包含環境變數 (例如%MyEnv%) 或通配符。

路徑結尾不需要反斜杠 (“”) 。 這是擷取此資訊以檢查的應用程式。

[in] lAttributes

公開陰影複製的屬性,指出它是否在本機或遠端公開。 此值必須是 VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY_VSS_VOLUME_SNAPSHOT_ATTRIBUTESVSS_VOLSNAP_ATTR_EXPOSED_REMOTELY值。

[in] wszExpose

當陰影複製公開為檔案共享時,此參數的值就是共享名稱。 如果陰影複製是透過將它掛接為裝置來公開,參數值就是驅動器號,後面接著冒號,例如 “X:” 或掛接的資料夾路徑 (,例如“Y:\MountX”) 。 如果此參數的值是 NULL,則 VSS 會在 lAttributes 參數 VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY時決定共用名或驅動器號。

[out] pwszExposed

陰影複製的公開名稱。 這是共用名稱、驅動器號後面接著冒號或掛接的資料夾。 如果 PublicSnapshot 失敗,則值為 NULL。 VSS 會配置此字串的記憶體。

傳回值

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

意義
S_OK
陰影複製已成功公開。
E_ACCESSDENIED
呼叫端沒有足夠的備份許可權,或不是系統管理員。
E_INVALIDARG
其中一個參數值無效。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE
備份元件物件未初始化、此方法已在還原作業期間呼叫,或此方法未在正確的順序內呼叫。
VSS_E_OBJECT_NOT_FOUND
指定的陰影複製不存在。
VSS_E_PROVIDER_VETO
預期的提供者錯誤。 提供者在事件記錄檔中記錄錯誤。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理
VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支援此值。 改用E_UNEXPECTED。

VSS_E_UNEXPECTED_PROVIDER_ERROR
未預期的提供者錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

備註

呼叫端負責釋放 pwszExposed 參數所指向的字串,方法是呼叫 CoTaskMemFree 函式。

公開持續性陰影複製時,它會繼續透過後續開機公開。

公開磁碟區的陰影複製時,陰影複製可能會被視為可掛接的裝置,或是檔案共用可用的文件系統。

當它公開為裝置時,如同其他可掛接裝置一樣,磁碟區的陰影複製會在磁碟區的裝入點公開, (驅動器號或掛接的資料夾) 從根目錄開始。

當公開為檔案共享時,可以共用磁碟區 ) wszPathFromRoot 所指示的子集 (。

如需如何公開陰影複製的詳細資訊,請參閱 公開和呈現陰影複製的磁碟區

規格需求

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

另請參閱

IVssBackupComponents

IVssBackupComponents::ImportSnapshots

IVssBackupComponentsEx2::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES