Fonction DismAddPackage
Ajoute un seul fichier .cab ou .msu à une image Windows.
Syntaxe
HRESULT WINAPI DismAddPackage(
_In_ DismSession Session,
_In_ PCWSTR PackagePath,
_In_ BOOL IgnoreCheck,
_In_ BOOL PreventPending,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Paramètres
Session [entrée]
Une DismSession valide. La DismSession doit être associée à une image. Vous pouvez associer une session à une image à l’aide de DismOpenSession.
PackagePath [in]
Chemin d’accès relatif ou absolu au fichier .cab ou .msu ajouté, ou dossier contenant les fichiers développés d’un fichier .cab unique.
IgnoreCheck [in]
Valeur booléenne pour spécifier s’il faut ignorer les vérifications d’applicabilité internes effectuées lors de l’ajout d’un package.
| Valeur | Description |
|---|---|
| TRUE | Ignorez les vérifications d’applicabilité internes. |
| FALSE | N’ignorez pas les vérifications d’applicabilité internes. |
PreventPending [in]
Valeur booléenne pour spécifier s’il faut ajouter un package s’il a des actions en ligne en attente.
| Valeur | Description |
|---|---|
| TRUE | Empêchez l’installation d’un package contenant des actions en ligne en attente. |
| FALSE | Autorisez l’installation d’un package contenant des actions en ligne en attente. |
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 un DismProgressCallback défini par le client.
UserData [entrée, facultatif]
Optionnel. Données personnalisées définies par l’utilisateur.
Valeur retournée
Retourne S_OK en cas de réussite.
Notes
Seuls .cab fichiers peuvent être ajoutés à une image en ligne. Les fichiers .cab ou .msu peuvent être ajoutés à une image hors connexion.
Cette fonction retourne un code d’erreur spécial si le package n’est pas applicable. Vous pouvez utiliser DismGetPackageInfo pour déterminer si un package s’applique à l’image cible.
Exemple
HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, NULL, NULL, NULL);
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 les Informations de référence technique Windows ADK. |
| Plateformes d’images prises en charge | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, environnement de préinstallation Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| 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 |