DismGetPackageInfo 函数
获取标准包属性作为 DismGetPackages,以及更具体的包信息和自定义属性。
语法
HRESULT WINAPI DismGetPackageInfo(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_Out_ DismPackageInfo **PackageInfo
);
参数
Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。
Identifier [in]
.cab 文件的绝对路径或包名称,具体取决于 PackageIdentifier 参数值。
PackageIdentifier [in]
有效的 DismPackageIdentifier 枚举值。
值 | 说明 |
---|---|
PackageName | 要使用包名称指定包时,请使用此值。 |
PackagePath | 要使用 .cab 文件或包含扩展包的文件夹的绝对路径指定包时,请使用此值。 |
PackageNone | 不是此函数的有效值。 |
PackageInfo [out]
指向 DismPackageInfo 结构数组地址的指针。
返回值
如果成功,则返回 S_OK。
注解
可以使用此函数来确定包是否适用于指定映像。 DismPackageInfo结构包含一个“适用”字段,该字段是一个布尔值,如果包适用,则返回 TRUE;如果包不适用于指定映像,则返回 FALSE。
示例
HRESULT hr = S_OK;
DismPackageInfo PackageInfo;
hr = DismGetPackageInfo(Session, "C:\packages\calc.cab", PackagePath, &PackageInfo);
要求
要求 | 说明 |
---|---|
支持的主机平台 | 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 |