Fonction DismAddCapability
Ajoute une fonctionnalité à une image.
Syntaxe
HRESULT WINAPI DismAddCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_In_ BOOL LimitAccess,
_In_ PCWSTR* SourcePaths,
_In_opt_ UINT SourcePathCount,
_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.
Nom [in]
Nom de la fonctionnalité en cours d’ajout.
LimitAccess [in]
L’indicateur indique si WU/WSUS doit être contacté en tant qu’emplacement source pour télécharger la charge utile d’une fonctionnalité. Si la charge utile de la fonctionnalité à ajouter existe, l’indicateur est ignoré.
SourcePaths [in]
Liste des emplacements sources. La fonction recherche les fichiers de charge utile supprimés à partir des emplacements spécifiés dans SourcePaths et, si elle est introuvable, poursuit la recherche en contactant WU/WSUS en fonction du paramètre LimitAccess.
SourcePathCount [in, facultatif]
Nombre d’entrées dans SourcePaths.
CancelEvent [entrée, facultatif]
Il s’agit d’un handle d’un événement pour l’annulation.
Progress [entrée, facultatif]
Pointeur vers une fonction de rappel définie par le client pour signaler la progression.
UserData [entrée, facultatif]
Données personnalisées définies par l’utilisateur. Cette valeur est renvoyée à l’utilisateur via le rappel.
Valeur retournée
Retourne S_OK en cas de réussite.
Notes
Utilisez cette fonction pour ajouter une fonctionnalité.
Exemple
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, 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 10, Windows Server 2016 |
| Client minimal pris en charge | Windows 10 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 [applications de bureau uniquement] |
| En-tête | DismAPI.h |
| Bibliothèque | DismAPI.lib |
| DLL | DismAPI.dll |