Метод IAssemblyCache::UninstallAssembly (winsxs.h)

Статья
03/15/2023

Метод UnistallAssembly удаляет ссылку приложения на сборку из параллельного хранилища. Если другие приложения не ссылаются на сборку, сборка становится непригодной для использования. Windows может удалить файлы сборки из параллельного хранилища и освободить место на диске позже.

Синтаксис

HRESULT UninstallAssembly(
  [in]            DWORD                       dwFlags,
  [in]            LPCWSTR                     pszAssemblyName,
  [in]            LPCFUSION_INSTALL_REFERENCE pRefData,
  [out, optional] ULONG                       *pulDisposition
);

Параметры

[in] dwFlags

Этот параметр должен иметь значение 0.

[in] pszAssemblyName

Указатель на строковое значение, завершающееся нулевым значением, которое содержит полностью указанное строгое имя сборки. Если полное имя не указано, результат не определен.

[in] pRefData

Указатель на структуру FUSION_INSTALL_REFERENCE , описывающую приложение, которое содержит ссылку на удаляемую сборку. Если это значение равно NULL, ссылки на сборку приложений не остаются в параллельном хранилище и файлы сборки удаляются.

Примечание Символы \, /, :, ;, *, <, , >и | недопустимы в идентификаторе ссылки.

[out, optional] pulDisposition

Указатель на целочисленное значение, описывающее выполненное действие.

Параметр pulDisposition может содержать одно из следующих значений или значение NULL.

Значение	Значение
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED	Файлы сборки были удалены из параллельного хранилища.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE	Файлы сборки не были удалены, так как приложение использует сборку.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED	Сборка не существует в параллельном хранилище.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING	Зарезервировано.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES	Файлы сборки не были удалены, так как параллельное хранилище содержит ссылку на сборку другого приложения.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND	Ссылка, указанная в pRefData , не существует в параллельном хранилище.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемое значение	Описание
S_OK	Файлы сборки были удалены из параллельного хранилища.
S_FALSE	Операция выполнена успешно, и ссылка на сборку была удалена. Файлы сборки не были удалены из параллельного хранилища по причине, описанной значением, возвращаемым pulDisposition.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winsxs.h
DLL	Sxs.dll

См. также раздел

IAssemblyCache

Поделиться через