Partager via


Fonction DismGetFeatures

Obtient toutes les fonctionnalités d’une image, que les fonctionnalités soient activées ou désactivées.

Syntaxe

HRESULT WINAPI DismGetFeatures(
  _In_     DismSession           Session,
  _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.

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.

Exemple

HRESULT hr = S_OK;
DismFeature* Feature;
UINT FeatureCount;
hr = DismGetFeatures(Session, 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

Voir aussi

DismEnableFeature

DismDisableFeature

DismGetFeatureInfo

DismGetFeatureParent

DismDelete