Функция 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
);
Параметры
сеанс [в]
Допустимый DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.
имя [в]
Имя добавляемой возможности.
ОграничитьДоступ [вход]
Флаг указывает, следует ли использовать WU/WSUS в качестве источника для загрузки данных функциональности. Если полезная нагрузка добавляемой функции существует, флаг игнорируется.
SourcePaths [in]
Список исходных мест. Функция должна искать перемещенные пакетные файлы из расположений, указанных в SourcePaths, и, если они не найдены, продолжить поиск, связавшись с WU/WSUS в зависимости от параметра LimitAccess.
SourcePathCount [in, необязательный]
Количество записей в SourcePaths.
CancelEvent [входной, необязательный]
Это дескриптор события для отмены.
Прогресс [в, по желанию]
Указатель на определяемую клиентом функцию обратного вызова для отчета о ходе выполнения.
UserData [in, необязательный]
Определяемые пользователем пользовательские данные. Это будет передано пользователю через обратный вызов.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение 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);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы хостов | API DISM можно использовать в любой операционной системе, поддерживаемой пакетом средств оценки и развертывания Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике Windows ADK. |
| Поддерживаемые платформы изображений | Windows 10, Windows Server 2016 |
| Минимальный поддерживаемый клиент | Windows 10 [только настольные приложения] |
| Минимальный поддерживаемый сервер | Windows Server 2016 [только настольные приложения] |
| Заголовок | DismAPI.h |
| Библиотека | DismAPI.lib |
| Библиотека DLL | DismAPI.dll |