DismAddCapability 函数
将功能添加到映像。
语法
HRESULT WINAPI DismAddCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_In_ BOOL LimitAccess,
_In_ PCWSTR* SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
参数
Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。
Name [in]
要添加的功能的名称。
LimitAccess [in]
该标志指示是否应将 WU/WSUS 作为用于下载功能有效负载的源位置来联系。 如果要添加的功能存在有效负载,将忽略该标志。
SourcePaths [in]
源位置的列表。 该函数应从 SourcePaths 中指定的位置查找已删除的有效负载文件,如果找不到,则通过与 WU/WSUS 联系,根据参数 LimitAccess 继续搜索。
SourcePathCount [in, optional]
SourcePaths 中的条目计数。
CancelEvent [in, optional]
这是一个用于取消的事件的句柄。
Progress [in, optional]
一个指针,指向用于报告进度的客户端定义的回调函数。
UserData [in, optional]
用户定义的自定义数据。 会通过回调将其传递回用户。
返回值
成功时返回 S_OK
。
注解
使用此函数可添加功能。
示例
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, NULL, NULL, NULL);
要求
要求 | 说明 |
---|---|
支持的主机平台 | DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息,请参阅 Windows ADK 技术参考。 |
支持的映像平台 | Windows 10、Windows Server 2016 |
最低受支持的客户端 | Windows 10 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
标头 | DismAPI.h |
Library | DismAPI.lib |
DLL | DismAPI.dll |