Funzione DismMountImage
Monta un file di immagine WIM o VHD in un percorso specificato.
Sintassi
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
);
Parametri
ImageFilePath [in]
Percorso del file WIM o VHD nel computer locale. È necessaria un'estensione con estensione wim, vhd o file vhdx.
MountPath [in]
Percorso della posizione in cui deve essere montata l'immagine. Questo percorso di montaggio deve già esistere nel computer. L'immagine di Windows in un file con estensione wim, vhd o vhdx può essere montata in una cartella vuota in un'unità formattata NTFS. Un'immagine di Windows in un file con estensione vhd o vhdx può essere montata anche in una lettera di unità non assegnata. Non è possibile montare un'immagine nella radice dell'unità esistente.
ImageIndex [in]
Indice dell'immagine nel file WIM da montare. Per un file VHD, è necessario specificare un indice di 1.
ImageName [in, facoltativo]
Facoltativa. Nome dell'immagine da montare.
ImageIdentifier [in]
Valore di enumerazione DismImageIdentifier , ad esempio DismImageIndex.
Flag [in]
Flag di montaggio da usare per questa operazione. Per altre informazioni sui flag di montaggio, vedere Costanti API DISM.
CancelEvent [in, facoltativo]
Facoltativa. È possibile impostare CancelEvent per questa funzione per annullare l'operazione in corso quando viene segnalato dal client. Se cancelEvent viene ricevuto in una fase quando l'operazione non può essere annullata, l'operazione continuerà e restituirà un codice di esito positivo. Se cancelEvent viene ricevuto e l'operazione viene annullata, lo stato dell'immagine è sconosciuto. È necessario verificare lo stato dell'immagine prima di continuare o ignorare le modifiche e ricominciare.
Stato [in, facoltativo]
Facoltativa. Puntatore a una funzione DismProgressCallback definita dal client.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
Valore restituito
Restituisce S_OK sull'esito positivo.
Restituisce E_INVALIDARG se uno dei percorsi non è ben formato o se MountPath o ImageFilePath non esiste o non è valido.
Restituisce un codice di errore Win32 mappato a un HRESULT per altri errori.
Commenti
Dopo aver montato un'immagine, usare DismOpenSession per avviare una sessione di manutenzione. Per altre informazioni, vedere Uso dell'API DISM.
Il montaggio di un'immagine da un file WIM o VHD archiviato nella rete non è supportato. È necessario specificare un file nel computer locale.
Per montare un'immagine da un file VHD, è necessario specificare un oggetto ImageIndex di 1.
MountPath deve essere un percorso di file già esistente nel computer. Le immagini nei file WIM e VHD possono essere montate in una cartella vuota in un'unità formattata NTFS. È anche possibile montare un'immagine da un file VHD a una lettera di unità non assegnata. Non è possibile montare un'immagine nella radice dell'unità esistente.
Quando si monta un'immagine in un file WIM, l'immagine può essere identificata dal numero di indice dell'immagine specificato da ImageIndex o dal nome dell'immagine specificata da ImageName. ImageIdentifier specifica se usare il parametro ImageIndex o ImageName per identificare l'immagine.
Esempio
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);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate per i file con estensione wim | L'API DISM può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per altre informazioni, vedere Informazioni di riferimento tecnico su Windows ADK. |
| Piattaforme host supportate per file con estensione vhd e vhdx | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | DismAPI.h |
| Libreria | DismAPI.lib |
| DLL | DismAPI.dll |