Функция DismGetFeatureInfo
Получает подробные сведения для указанного компонента.
Синтаксис
HRESULT WINAPI DismGetFeatureInfo(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeatureInfo **FeatureInfo
);
Параметры
Сеанс [in]
Допустимое DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.
FeatureName [in]
Имя функции, о которой требуется получить дополнительные сведения.
Идентификатор [in, необязательный]
Необязательный элемент. Абсолютный путь к файлу .cab или имя пакета в зависимости от значения параметра PackageIdentifier .
PackageIdentifier [in, необязательный]
Необязательный элемент. Допустимое значение перечисления DismPackageIdentifier .
| Значение | Описание |
|---|---|
| PackageName | Используйте это значение, если требуется указать пакет с помощью имени пакета. |
| PackagePath | Используйте это значение, если требуется указать пакет, используя абсолютный путь к файлу .cab. |
| PackageNone | Недопустимое значение для этой функции. |
FeatureInfo [out]
Указатель на адрес массива структур DismFeatureInfo .
Возвращаемое значение
В случае успешного выполнения возвращает S_OK .
Комментарии
Эту функцию можно использовать для получения пользовательских свойств компонента. Если компонент имеет настраиваемые свойства, они будут храниться в поле CustomProperty в виде массива. Не все функции имеют пользовательские свойства.
Пример
HRESULT hr = S_OK;
DismFeatureInfo FeatureInfo;
hr = DismGetFeatureInfo(Session, "Xps-Foundation-Xps-Viewer", NULL, NULL, &FeatureInfo);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы узлов | 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 |