Método IAssemblyCache::UninstallAssembly (winsxs.h)

Artigo
08/27/2023

O método UnistallAssembly remove uma referência de aplicativo a um assembly do repositório lado a lado. Se não houver outras referências ao assembly por outros aplicativos, o assembly se tornará inutilizável. O Windows pode remover os arquivos do assembly do repositório lado a lado e recuperar espaço em disco posteriormente.

Sintaxe

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

Parâmetros

[in] dwFlags

Esse parâmetro deve ser 0.

[in] pszAssemblyName

Um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o nome forte totalmente especificado do assembly. Se o nome completo não for fornecido, o resultado será indefinido.

[in] pRefData

Um ponteiro para uma estrutura FUSION_INSTALL_REFERENCE que descreve o aplicativo que contém a referência ao assembly que está sendo removido. Se esse valor for nulo, nenhuma referência ao assembly por aplicativos será deixada no repositório lado a lado e os arquivos do assembly serão removidos.

Nota Os caracteres \, /, :, ;, *, <, >e | são inválidos na ID de referência.

[out, optional] pulDisposition

Um ponteiro para um valor inteiro que descreve a ação executada.

O parâmetro pulDisposition pode conter um dos seguintes valores ou nulo.

Valor	Significado
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED	Os arquivos de assembly foram removidos do repositório lado a lado.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE	Os arquivos do assembly não foram removidos porque um aplicativo está usando o assembly.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED	O assembly não existe no repositório lado a lado.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING	Reservado.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES	Os arquivos do assembly não foram removidos porque o repositório lado a lado contém uma referência ao assembly por outro aplicativo.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND	A referência especificada em pRefData não existe no repositório lado a lado.

Valor retornado

Esse método pode retornar um desses valores.

Valor retornado	Descrição
S_OK	Os arquivos do assembly foram removidos do repositório lado a lado.
S_FALSE	A operação foi bem-sucedida e a referência ao assembly foi removida. Os arquivos de assembly não foram removidos do repositório lado a lado pelo motivo descrito pelo valor retornado por pulDisposition.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winsxs.h
DLL	Sxs.dll

Confira também

IAssemblyCache

Compartilhar via