DismGetFeatureParent 函数

获取指定功能的父功能。

语法

HRESULT WINAPI DismGetFeatureParent(
  _In_     DismSession           Session,
  _In_     PCWSTR                FeatureName,
  _In_opt_ PCWSTR                Identifier,
  _In_opt_ DismPackageIdentifier PackageIdentifier,
  _Out_    DismFeature           **Feature,
  _Out_    UINT                  *Count
);

参数

Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。

FeatureName [in]
要查找其父功能的功能的名称。

Identifier [in,可选]
可选。 .cab 文件的绝对路径或包名称,具体取决于 PackageIdentifier 参数值。

PackageIdentifier [in,可选]
可选。 有效的 DismPackageIdentifier 枚举值。

说明
PackageName 要使用包名称指定包时,请使用此值。
PackagePath 要使用 .cab 文件的绝对路径指定包时,请使用此值。
PackageNone 不是此函数的有效值。

Feature [out]
指向 DismFeature 结构数组地址的指针。

Count [out]
返回的 DismFeature 结构的数量。

返回值

如果成功,则返回 S_OK。

注解

对于要启用的功能,必须启用一个或多个其父功能。 可以使用此函数枚举父功能并确定需要启用的父功能。

示例

HRESULT hr = S_OK;
DismFeature* Feature;
UINT FeatureCount;
hr = DismGetFeatureParent(Session,"Xps-Foundation-Xps-Viewer", NULL, NULL, &Feature, &FeatureCount);

要求

要求 说明
支持的主机平台 DISM API 可在 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
Library DismAPI.lib
DLL DismAPI.dll

另请参阅

DismEnableFeature

DismDisableFeature

DismGetFeatures

DismGetFeatureInfo

DismDelete