Fonction DismGetFeatureParent
Obtient les fonctionnalités parentes d’une fonctionnalité spécifiée.
Syntaxe
HRESULT WINAPI DismGetFeatureParent(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeature **Feature,
_Out_ UINT *Count
);
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.
FeatureName [in]
Nom de la fonctionnalité dont vous souhaitez trouver le parent.
Identificateur [in, facultatif]
facultatif. Chemin d’accès absolu à un fichier .cab ou nom du package, en fonction de la valeur du paramètre PackageIdentifier.
PackageIdentifier [in, facultatif]
facultatif. Valeur d’énumération DismPackageIdentifier valide.
| Valeur | Description |
|---|---|
| PackageName | Utilisez cette valeur lorsque vous souhaitez spécifier un package à l’aide du nom du package. |
| PackagePath | Utilisez cette valeur lorsque vous souhaitez spécifier un package à l’aide d’un chemin d’accès absolu à un fichier .cab. |
| PackageNone | N’est pas une valeur valide pour cette fonction. |
Fonctionnalité [out]
Pointeur vers l’adresse d’un tableau de structures DismFeature .
Nombre [sortie]
Nombre de structures DismFeature qui ont été retournées.
Valeur retournée
Renvoie S_OK en cas de réussite.
Notes
Pour qu’une fonctionnalité soit activée, une ou plusieurs de ses fonctionnalités parentes doivent être activées. Vous pouvez utiliser cette fonction pour énumérer les fonctionnalités parentes et déterminer quel parent doit être activé.
Exemple
HRESULT hr = S_OK;
DismFeature* Feature;
UINT FeatureCount;
hr = DismGetFeatureParent(Session,"Xps-Foundation-Xps-Viewer", NULL, NULL, &Feature, &FeatureCount);
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 |