DismGetFeatures 函数
获取映像中的所有功能,而不考虑已启用还是已禁用这些功能。
语法
HRESULT WINAPI DismGetFeatures(
_In_ DismSession Session,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_Out_ DismFeature **Feature,
_Out_ UINT *Count
);
参数
Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。
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 = DismGetFeatures(Session, 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 |