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_ATTRIBUTES 的 VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY值。
[in] wszExpose
當陰影複製公開為檔案共享時，此參數的值就是共享名稱。 如果陰影複製是透過將它掛接為裝置來公開，參數值就是驅動器號，後面接著冒號，例如 “X：” 或掛接的資料夾路徑 (，例如“Y：\MountX”) 。 如果此參數的值是 NULL，則 VSS 會在 lAttributes 參數 VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY時決定共用名或驅動器號。
[out] pwszExposed
陰影複製的公開名稱。 這是共用名稱、驅動器號後面接著冒號或掛接的資料夾。 如果 PublicSnapshot 失敗，則值為 NULL。 VSS 會配置此字串的記憶體。
傳回值
以下是此方法的有效傳回碼。
| 值 | 意義 |
|---|---|
|
陰影複製已成功公開。 |
|
呼叫端沒有足夠的備份許可權，或不是系統管理員。 |
|
其中一個參數值無效。 |
|
呼叫端記憶體不足或其他系統資源。 |
|
備份元件物件未初始化、此方法已在還原作業期間呼叫，或此方法未在正確的順序內呼叫。 |
|
指定的陰影複製不存在。 |
|
預期的提供者錯誤。 提供者在事件記錄檔中記錄錯誤。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。 |
|
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支援此值。 改用E_UNEXPECTED。 |
|
未預期的提供者錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。 |
備註
呼叫端負責釋放 pwszExposed 參數所指向的字串，方法是呼叫 CoTaskMemFree 函式。
公開持續性陰影複製時，它會繼續透過後續開機公開。
公開磁碟區的陰影複製時，陰影複製可能會被視為可掛接的裝置，或是檔案共用可用的文件系統。
當它公開為裝置時，如同其他可掛接裝置一樣，磁碟區的陰影複製會在磁碟區的裝入點公開， (驅動器號或掛接的資料夾) 從根目錄開始。
當公開為檔案共享時，可以共用磁碟區 ) wszPathFromRoot 所指示的子集 (。
如需如何公開陰影複製的詳細資訊，請參閱 公開和呈現陰影複製的磁碟區。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
| 程式庫 | VssApi.lib |
另請參閱
IVssBackupComponents：：ImportSnapshots