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
);
參數
工作階段 [in]
有效的 DismSession。 DismSession 必須與映像相關聯。 您可以使用 DismOpenSession，將會話與映像產生關聯。
名稱 [in]
要新增的功能名稱。
LimitAccess [in]
旗標會指出是否應連絡 WU/WSUS 作為下載功能模組負載的來源位置。 如果要新增的功能載荷已經存在，則會忽略該旗標。
SourcePaths [in]
來源位置的清單。 函式應該從SourcePaths中指定的位置查閱已移除的承載檔案，如果找不到，請根據參數 LimitAccess 連絡 WU/WSUS 以繼續搜尋。
SourcePathCount [in， 選擇性]
SourcePaths 中的項目計數。
CancelEvent [in，選擇性]
這是一個用於取消事件的控制代碼。
進度 [in，選填]
用戶端定義的回呼函式指標，用於報告進度。
UserData [輸入， 可選]
使用者定義的自定義數據。 這會透過回呼傳回給使用者。
傳回值
如果函式成功，則傳回值會 S_OK。 函式也可能在成功時傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
|
如果 工作階段 已上線，則必須重新啟動電腦。 |
|
必須重載 會話。 |
如果函式失敗，傳回值是 HRESULT 錯誤值。
備註
使用此函式來新增功能。
例
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 |
| 圖書館 | DismAPI.lib |
| DLL | DismAPI.dll |