Fonction DismMountImage

Monte un fichier image WIM ou VHD à un emplacement spécifié.

Syntaxe

HRESULT WINAPI DismMountImage(
  _In_     PCWSTR                 ImageFilePath,
  _In_     PCWSTR                 MountPath,
  _In_     UINT                   ImageIndex,
  _In_opt_ PCWSTR                 ImageName,
  _In_     DismImageIdentifier    ImageIdentifier,
  _In_     DWORD                  Flags,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

Paramètres

ImageFilePath [in]
Chemin d’accès au fichier WIM ou VHD sur l’ordinateur local. Une extension de nom de fichier .wim, .vhd ou .vhdx est requise.

MountPath [in]
Chemin d’accès de l’emplacement où l’image doit être montée. Ce chemin de montage doit déjà exister sur l’ordinateur. L’image Windows d’un fichier .wim, .vhd ou .vhdx peut être montée dans un dossier vide sur un lecteur au format NTFS. Une image Windows dans un fichier .vhd ou .vhdx peut également être montée sur une lettre de lecteur non attribuée. Vous ne pouvez pas monter une image à la racine du lecteur existant.

ImageIndex [in]
Index de l’image dans le fichier WIM que vous souhaitez monter. Pour un fichier de disque dur virtuel, vous devez spécifier un index de 1.

ImageName [in, facultatif]
facultatif. Nom de l’image que vous souhaitez monter.

ImageIdentifier [in]
Valeur d’énumération DismImageIdentifier telle que DismImageIndex.

Indicateurs [in]
Indicateurs de montage à utiliser pour cette opération. Pour plus d’informations sur les indicateurs de montage, consultez Constantes de l’API DISM.

CancelEvent [entrée, facultatif]
Optionnel. Vous pouvez définir un CancelEvent pour cette fonction afin d’annuler l’opération en cours lorsqu’elle est signalée par le client. Si l’événement CancelEvent est reçu à un stade où l’opération ne peut pas être annulée, l’opération continue et retourne un code de réussite. Si l’événement CancelEvent est reçu et que l’opération est annulée, l’état de l’image est inconnu. Vous devez vérifier l’état de l’image avant de continuer ou d’ignorer les modifications et de recommencer.

Progress [entrée, facultatif]
Optionnel. Pointeur vers une fonction DismProgressCallback définie par le client.

UserData [entrée, facultatif]
Optionnel. Données personnalisées définies par l’utilisateur.

Valeur retournée

Renvoie S_OK en cas de réussite.

Renvoie E_INVALIDARG si l’un des chemins d’accès n’est pas correctement formé ou si MountPath ou ImageFilePath n’existe pas ou n’est pas valide.

Retourne un code d’erreur Win32 mappé à un HRESULT pour d’autres erreurs.

Notes

Après le montage d’une image, utilisez DismOpenSession pour démarrer une session de maintenance. Pour plus d’informations, consultez Utilisation de l’API DISM.

Le montage d’une image à partir d’un fichier WIM ou VHD stocké sur le réseau n’est pas pris en charge. Vous devez spécifier un fichier sur l’ordinateur local.

Pour monter une image à partir d’un fichier VHD, vous devez spécifier une imageIndex de 1.

MountPath doit être un chemin de fichier qui existe déjà sur l’ordinateur. Les images des fichiers WIM et VHD peuvent être montées dans un dossier vide sur un lecteur au format NTFS. Vous pouvez également monter une image à partir d’un fichier VHD sur une lettre de lecteur non attribuée. Vous ne pouvez pas monter une image à la racine du lecteur existant.

Lors du montage d’une image dans un fichier WIM, l’image peut être identifiée par le numéro d’index de l’image spécifié par ImageIndex, ou le nom de l’image spécifié par ImageName. ImageIdentifier spécifie s’il faut utiliser le paramètre ImageIndex ou ImageName pour identifier l’image.

Exemple

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);

Spécifications

Voir aussi

DismUnmountImage

DismOpenSession