Функция DismGetPackageInfo
Возвращает стандартные свойства пакета в виде DismGetPackages, а также более конкретные сведения о пакете и пользовательские свойства.
Синтаксис
HRESULT WINAPI DismGetPackageInfo(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_Out_ DismPackageInfo **PackageInfo
);
Параметры
Сеанс [in]
Допустимое DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.
Идентификатор [in]
Абсолютный путь к файлу .cab или имя пакета в зависимости от значения параметра PackageIdentifier .
PackageIdentifier [in]
Допустимое значение перечисления DismPackageIdentifier .
| Значение | Описание |
|---|---|
| PackageName | Используйте это значение, если требуется указать пакет с помощью имени пакета. |
| PackagePath | Используйте это значение, если требуется указать пакет, используя абсолютный путь к файлу .cab или к папке, содержащей развернутый пакет. |
| PackageNone | Недопустимое значение для этой функции. |
PackageInfo [out]
Указатель на адрес массива структур DismPackageInfo .
Возвращаемое значение
Возвращает S_OK при успешном выполнении.
Комментарии
Эту функцию можно использовать, чтобы определить, применим ли пакет к указанному образу. Структура DismPackageInfo содержит поле Applicable , которое представляет собой логическое значение, которое возвращает значение TRUE , если пакет применим, и FALSE , если пакет неприменим к указанному образу.
Пример
HRESULT hr = S_OK;
DismPackageInfo PackageInfo;
hr = DismGetPackageInfo(Session, "C:\packages\calc.cab", PackagePath, &PackageInfo);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы узлов | API DISM можно использовать в любой операционной системе, поддерживаемой пакетом средств оценки и развертывания Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK. |
| Поддерживаемые платформы образов | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, среда предустановки Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10 Windows Server 2016 |
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Заголовок | DismAPI.h |
| Библиотека | DismAPI.lib |
| DLL | DismAPI.dll |