Documentation
-
WIMCaptureImage
-
Fonctions
-
Structures
WIMApplyImage
Applique une image à un chemin de répertoire à partir d’un fichier d’image Windows (.wim).
BOOL
WINAPI
WIMApplyImage(
HANDLE hImage,
PCWSTR pszPath,
DWORD dwApplyFlags
);
hImage
[in] Un handle vers une image de volume retourné par les fonctions WIMLoadImage ou WIMCaptureImage.
pszPath
[in] Un pointeur vers une chaîne de caractères terminée par un null contenant le lecteur racine ou le chemin de répertoire où les données de l’image seront appliquées.
dwApplyFlags
[in] Spécifie comment le fichier doit être traité et quelles fonctionnalités doivent être utilisées.
| Indicateur | Description |
|---|---|
WIM_FLAG_VERIFY |
Vérifie que les fichiers correspondent aux données d’origine. |
WIM_FLAG_INDEX |
Spécifie que l’image doit être lue séquentiellement pour des raisons de mise en cache ou de performance. |
WIM_FLAG_NO_APPLY |
Applique l’image sans créer physiquement de répertoires ou de fichiers. Utile pour obtenir une liste des fichiers et des répertoires dans l’image. |
WIM_FLAG_FILEINFO |
Envoie un message WIM_MSG_FILEINFO pendant l’opération d’application. |
WIM_FLAG_NO_RP_FIX |
Désactive les correctifs de chemin d’accès automatiques pour les jonctions et les liens symboliques. |
WIM_FLAG_NO_DIRACL |
Désactive la restauration des informations de sécurité pour les répertoires. |
WIM_FLAG_NO_FILEACL |
Désactive la restauration des informations de sécurité pour les fichiers. |
Si la fonction réussit, alors la valeur de retour est non nulle.
Si la fonction échoue, alors la valeur de retour est nulle. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError.
Pour obtenir plus d’informations pendant l’application d’une image, voir la fonction WIMRegisterMessageCallback.
Pour obtenir la liste des fichiers dans une image sans réellement appliquer l’image, spécifiez le drapeau WIM_FLAG_NO_APPLY et enregistrez un rappel qui gère le message WIM_MSG_PROCESS. Pour obtenir des informations supplémentaires sur les fichiers à partir du message WIM_MSG_FILEINFO, spécifiez WIM_FLAG_FILEINFO.