DismOpenSession-Funktion
Ordnet ein Windows-Offline- oder -Onlineimage einer DISMSession zu.
Syntax
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
Parameter
ImagePath [in]
Legen Sie ImagePath auf einen der folgenden Werte fest:
- Ein absoluter oder relativer Pfad zum Stammverzeichnis eines Windows-Offlineimages.
- Ein absoluter oder relativer Pfad zum Stammverzeichnis eines eingebundenen Windows-Images. Sie können das Image vor dem Aufrufen von DismOpenSession mithilfe eines externen Tools oder von DismMountImage einbinden.
- DISM_ONLINE_IMAGE zum Zuordnen der Sitzung zu der Windows-Onlineinstallation.
WindowsDirectory [in, optional]
Optional. Ein relativer oder absoluter Pfad zum Windows Verzeichnis. Der Pfad ist relativ zum Bereitstellungspunkt.
Bei einem Wert von NULL für WindowsDirectory wird der Standardwert „Windows“ verwendet.
Der Parameter WindowsDirectory kann nicht verwendet werden, wenn der Parameter ImagePath auf DISM_ONLINE_IMAGE festgelegt ist.
SystemDrive [in, optional]
Optional. Der Buchstabe des Systemlaufwerks, das den Start-Manager enthält. Bei einem Wert von NULL für SystemDrive wird als Standardwert das Laufwerk verwendet, das den Bereitstellungspunkt enthält.
Der Parameter SystemDrive kann nicht verwendet werden, wenn der Parameter ImagePath auf DISM_ONLINE_IMAGE festgelegt ist.
Sitzung [out]
Eine gültige DismSession. Die DismSession muss einem Image zugeordnet sein. Sie können eine Sitzung mithilfe von DismOpenSession einem Image zuordnen.
Rückgabewert
Gibt bei Erfolg S_OK zurück.
Gibt HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) zurück, wenn der DismSession bereits ein Image zugeordnet ist.
Gibt bei anderen Fehlern einen Win32-Fehlercode zurück, der einem HRESULT zugeordnet ist.
Bemerkungen
Die DismSession kann verwendet werden, um ein Image nach dem erfolgreichen Abschluss des DismOpenSession-Aufrufs zu warten. Die DismSession muss durch Aufrufen von DismCloseSession heruntergefahren werden.
Beispiel
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Anforderungen
| Anforderung | Beschreibung |
|---|---|
| Unterstützte Hostplattformen | Die DISM-API kann auf jedem Betriebssystem verwendet werden, das vom Windows Assessment and Bereitstellung Kit (Windows ADK) unterstützt wird. Weitere Informationen finden Sie in der technischen Referenz zum Windows ADK. |
| 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 |