Fonction DismGetPackageInfo
Génère des propriétés de package standard en tant que DismGetPackages, ainsi que des informations de package plus spécifiques et des propriétés personnalisées.
Syntaxe
HRESULT WINAPI DismGetPackageInfo(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_Out_ DismPackageInfo **PackageInfo
);
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 la DismOpenSession.
Identificateur [entrée]
Chemin d’accès absolu à un fichier .cab ou nom du package, en fonction de la valeur du paramètre PackageIdentifier.
PackageIdentifier [entrée]
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 ou à un dossier contenant un package développé. |
| PackageNone | N’est pas une valeur valide pour cette fonction. |
PackageInfo [sortie]
Pointeur vers l’adresse d’un tableau de structures DismPackageInfo.
Valeur retournée
Renvoie S_OK en cas de réussite.
Notes
Vous pouvez utiliser cette fonction afin de déterminer si un package est applicable à l’image spécifiée. La structure DismPackageInfo contient un champ Applicable, qui équivaut à une valeur booléenne qui renvoie TRUE si le package est applicable et FALSE si le package n’est pas applicable à l’image spécifiée.
Exemple
HRESULT hr = S_OK;
DismPackageInfo PackageInfo;
hr = DismGetPackageInfo(Session, "C:\packages\calc.cab", PackagePath, &PackageInfo);
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 |