DismMountImage 函式
將 WIM 或 VHD 映射檔掛接至指定的位置。
語法
HRESULT WINAPI DismMountImage(
_In_ PCWSTR ImageFilePath,
_In_ PCWSTR MountPath,
_In_ UINT ImageIndex,
_In_opt_ PCWSTR ImageName,
_In_ DismImageIdentifier ImageIdentifier,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
參數
ImageFilePath [in]
本機電腦上的 WIM 或 VHD 檔案路徑。 需要 .wim、.vhd 或 .vhdx 副檔名。
MountPath [in]
應該掛接映射的位置路徑。 此掛接路徑必須已存在於電腦上。 .wim、.vhd 或 .vhdx 檔案中的 Windows 映像可以掛接至 NTFS 格式化磁片磁碟機上的空白資料夾。 .vhd 或 .vhdx 檔案中的 Windows 映像也可以掛接至未指派的磁碟機號。 您無法將映射掛接至現有磁片磁碟機的根目錄。
ImageIndex [in]
您想要掛接之 WIM 檔案中映射的索引。 針對 VHD 檔案，您必須指定 的 1 索引。
ImageName [in， optional]
選擇性。 您要掛接的映射名稱。
ImageIdentifier [in]
DismImageIdentifier列舉值，例如DismImageIndex。
旗標 [in]
要用於這項作業的掛接旗標。 如需掛接旗標的詳細資訊，請參閱 DISM API 常數。
CancelEvent [in， optional]
選擇性。 您可以為此函式設定 CancelEvent ，以便在用戶端發出訊號時取消進行中的作業。 如果在無法取消作業的階段收到 CancelEvent ，作業將會繼續並傳回成功碼。 如果收到 CancelEvent 並取消作業，則映射狀態為未知。 您應該先確認映射狀態，再繼續或捨棄變更，然後再啟動一次。
進度 [in， 選擇性]
選擇性。 用戶端定義 DismProgressCallback 函式的指標。
UserData [in， optional]
選擇性。 使用者定義的自訂資料。
傳回值
傳回成功時的 S_OK 。
如果任何路徑格式不正確或MountPath或ImageFilePath不存在或無效，則傳回E_INVALIDARG。
傳回對應至 HRESULT 之其他錯誤的 Win32 錯誤碼。
備註
掛接映射之後，請使用 DismOpenSession 來啟動服務會話。 如需詳細資訊，請參閱 使用 DISM API。
不支援從儲存在網路上的 WIM 或 VHD 檔案掛接映射。 您必須在本機電腦上指定檔案。
若要從 VHD 檔案掛接映射，您必須指定 的 1ImageIndex。
MountPath必須是電腦上已經存在的檔案路徑。 WIM 和 VHD 檔案中的映射可以掛接至 NTFS 格式化磁片磁碟機上的空白資料夾。 您也可以將映射從 VHD 檔案掛接至未指派的磁碟機號。 您無法將映射掛接至現有磁片磁碟機的根目錄。
在 WIM 檔案中掛接映射時，映射可以透過 ImageIndex所指定的影像索引編號或 ImageName所指定的映射名稱來識別。 ImageIdentifier 會指定要使用 ImageIndex 或 ImageName 參數來識別影像。
範例
HRESULT hr = S_OK;
hr = DismMountImage(L” C:\\test\\images\\myimage.wim”, L"C:\\test\\offline", 1, NULL, DismImageIndex, DISM_MOUNT_READWRITE, NULL, NULL, NULL);
規格需求
| 需求 | 描述 |
|---|---|
| .wim 檔案支援的主機平臺 | DISM API 可用於 Windows 評定與部署套件所支援的任何作業系統， (Windows ADK) 。 如需詳細資訊，請參閱 Windows ADK 技術參考。 |
| .vhd 和 .vhdx 檔案支援的主機平臺 | Windows 7、Windows Server 2008 R2、Windows PE 3.0、Windows 8、Windows Server 2012、Windows 預先安裝環境 (Windows PE) 4.0、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016 |
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
| 標頭 | DismAPI.h |
| 程式庫 | DismAPI.lib |
| DLL | DismAPI.dll |