Funzione DismOpenSession
Associa un'immagine di Windows offline o online a una sessione DISMSession.
Sintassi
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
Parametri
ImagePath [in]
Impostare ImagePath su uno dei valori seguenti:
- Percorso assoluto o relativo della directory radice di un'immagine di Windows offline.
- Percorso assoluto o relativo della directory radice di un'immagine di Windows montata. È possibile montare l'immagine prima di chiamare DismOpenSession usando uno strumento esterno o usando DismMountImage.
- DISM_ONLINE_IMAGE associare la sessione all'installazione online di Windows.
WindowsDirectory [in, facoltativo]
Facoltativa. Percorso relativo o assoluto della directory di Windows. Il percorso è relativo al punto di montaggio.
Se il valore di WindowsDirectory è NULL, viene usato il valore predefinito "Windows".
Impossibile usare il parametro WindowsDirectory quando il parametro ImagePath è impostato su DISM_ONLINE_IMAGE.
SystemDrive [in, facoltativo]
Facoltativa. Lettera dell'unità di sistema che contiene il gestore di avvio. Se SystemDrive è NULL, viene usato il valore predefinito dell'unità contenente il punto di montaggio.
Impossibile usare il parametro SystemDrive quando il parametro ImagePath è impostato su DISM_ONLINE_IMAGE.
Sessione [out]
DismSession valido. L'oggetto DismSession deve essere associato a un'immagine. È possibile associare una sessione a un'immagine usando DismOpenSession.
Valore restituito
Restituisce S_OK sull'esito positivo.
Restituisce HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) se DismSession ha già un'immagine associata.
Restituisce un codice di errore Win32 mappato a un HRESULT per altri errori.
Commenti
La funzionalità DismSession può essere usata per il servizio dell'immagine dopo il completamento della chiamata DismOpenSession . La funzione DismSession deve essere arrestata chiamando DismCloseSession.
Esempio
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate | 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 |
| 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 |