Fonction DismGetFeatureInfo
Obtient des informations détaillées à partir de la fonctionnalité spécifiée.
Syntaxe
HRESULT WINAPI DismGetFeatureInfo(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeatureInfo **FeatureInfo
);
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é sur laquelle vous souhaitez obtenir plus d’informations.
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. |
FeatureInfo [out]
Pointeur vers l’adresse d’un tableau de structures DismFeatureInfo .
Valeur retournée
Retourne S_OK en cas de réussite.
Notes
Vous pouvez utiliser cette fonction pour obtenir les propriétés personnalisées d’une fonctionnalité. Si la fonctionnalité a des propriétés personnalisées, elles seront stockées dans le champ CustomProperty en tant que tableau. Toutes les fonctionnalités n’ont pas de propriétés personnalisées.
Exemple
HRESULT hr = S_OK;
DismFeatureInfo FeatureInfo;
hr = DismGetFeatureInfo(Session, "Xps-Foundation-Xps-Viewer", NULL, NULL, &FeatureInfo);
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 |