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

另请参阅

DismGetPackages

DismRemovePackage

DismAddPackage

DismDelete