DismUnmountImage-Funktion
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
Wirft ein Windows-Image von einem angegebenen Speicherort aus.
Syntax
HRESULT WINAPI DismUnmountImage(
_In_ PCWSTR MountPath,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parameter
MountPath [in]
Ein relativer oder absoluter Pfad zum Einbindungsverzeichnis des Images.
Flaggen [in]
Die Auswerf-Flags, die für diesen Vorgang verwendet werden sollen. Weitere Informationen zu Auswerf-Flags finden Sie unter DISM-API-Konstanten.
CancelEvent [in, optional]
Optional. Sie können für diese Funktion ein CancelEvent setzen, um den laufenden Vorgang abzubrechen, wenn dies vom Client signalisiert wird. Wenn das CancelEvent zu einem Zeitpunkt empfangen wird, an dem der Vorgang nicht abgebrochen werden kann, wird der Vorgang fortgesetzt und ein Erfolgscode zurückgegeben. Wenn CancelEvent empfangen und der Vorgang abgebrochen wird, ist der Bildstatus unbekannt. Sie sollten den Bildstatus überprüfen, bevor Sie fortfahren, oder die Änderungen verwerfen und erneut beginnen.
Fortschritt [in, optional]
Optional. Ein Zeiger auf einen vom Client definierten DismProgressCallback.
Benutzerdaten [in, optional]
Optional. Benutzerdefinierte benutzerdefinierte Daten.
Rückgabewert
Gibt bei Erfolg S_OK zurück.
Bemerkungen
Nachdem Sie DismCloseSession zum Beenden aller aktiven DismSession verwendet haben, können Sie das Image mithilfe der Funktion DismUnmountImage auswerfen.
Beispiel
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);
Anforderungen
| Anforderung | Beschreibung |
|---|---|
| Unterstützte Hostplattformen für WIM-Images | Die DISM-API kann auf jedem Betriebssystem verwendet werden, das vom Windows Assessment and Deployment Kit (Windows ADK) unterstützt wird. Weitere Informationen finden Sie in der technischen Referenz zum Windows ADK. |
| Unterstützte Hostplattform für VHD-Images | 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 |
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Header | DismAPI.h |
| Bibliothek | DismAPI.lib |
| DLL | DismAPI.dll |