Funzione DismUnmountImage
[Alcune informazioni si riferiscono al prodotto pre-rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non offre garanzie, esplicite o implicite, rispetto alle informazioni fornite qui.
Smonta un'immagine di Windows da una posizione specificata.
Sintassi
HRESULT WINAPI DismUnmountImage(
_In_ PCWSTR MountPath,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parametri
MountPath [in]
Percorso relativo o assoluto della directory di montaggio dell'immagine.
Flag [in]
Flag di smontaggio da usare per questa operazione. Per altre informazioni sui flag di smontaggio, 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 un client definito da DismProgressCallback.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
Valore restituito
Restituisce S_OK sull'esito positivo.
Commenti
Dopo aver usato DismCloseSession per terminare ogni dismSession attiva, è possibile smontare l'immagine usando la funzione DismUnmountImage .
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);
hr = DismUnmountImage (L"C:\\test\\offline", DISM_COMMIT_IMAGE, NULL, NULL, NULL);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate per le immagini 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 le immagini VHD | 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 |