Fonction DismOpenSession
Associe une image Windows hors connexion ou en ligne à une DISMSession.
Syntaxe
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
Paramètres
ImagePath [in]
Définissez ImagePath sur l’une des valeurs suivantes :
- Chemin d’accès absolu ou relatif au répertoire racine d’une image Windows hors connexion.
- Chemin d’accès absolu ou relatif au répertoire racine d’une image Windows montée. Vous pouvez monter l’image avant d’appeler DismOpenSession à l’aide d’un outil externe ou de DismMountImage.
- DISM_ONLINE_IMAGE d’associer la session à l’installation de Windows en ligne.
WindowsDirectory [in, facultatif]
facultatif. Chemin d’accès relatif ou absolu au répertoire Windows. Le chemin est relatif au point de montage.
Si la valeur de WindowsDirectory est NULL, la valeur par défaut « Windows » est utilisée.
Le paramètre WindowsDirectory ne peut pas être utilisé lorsque le paramètre ImagePath est défini sur DISM_ONLINE_IMAGE.
SystemDrive [in, facultatif]
facultatif. Lettre du lecteur système qui contient le gestionnaire de démarrage. Si SystemDrive a la valeur NULL, la valeur par défaut du lecteur contenant le point de montage est utilisée.
Le paramètre SystemDrive ne peut pas être utilisé lorsque le paramètre ImagePath est défini sur DISM_ONLINE_IMAGE.
Session [out]
Une DismSession valide. La DismSession doit être associée à une image. Vous pouvez associer une session à une image à l’aide de DismOpenSession.
Valeur retournée
Renvoie S_OK en cas de réussite.
Retourne HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) si la DismSession a déjà une image associée.
Retourne un code d’erreur Win32 mappé à un HRESULT pour d’autres erreurs.
Notes
La DismSession peut être utilisée pour traiter l’image une fois l’appel DismOpenSession terminé. La DismSession doit être arrêtée en appelant DismCloseSession.
Exemple
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Spécifications
| Condition requise | Description |
|---|---|
| Plateformes hôtes prises en charge | L’API DISM peut être utilisée sur n’importe quel système d’exploitation pris en charge par le Kit de déploiement et d’évaluation Windows (Windows ADK). Pour plus d’informations, consultez la référence technique windows ADK. |
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | DismAPI.h |
| Bibliothèque | DismAPI.lib |
| DLL | DismAPI.dll |