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

Artículo
08/27/2023

El método UnistallAssembly quita una referencia de aplicación a un ensamblado del almacén en paralelo. Si no hay otras referencias al ensamblado por otras aplicaciones, el ensamblado se vuelve inutilizable. Windows puede quitar los archivos del ensamblado del almacén en paralelo y reclamar espacio en disco más adelante.

Sintaxis

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

Parámetros

[in] dwFlags

El valor de este parámetro deberá ser 0.

[in] pszAssemblyName

Puntero a un valor de cadena terminada en null que contiene el nombre seguro especificado por completo del ensamblado. Si no se proporciona el nombre completo, el resultado no está definido.

[in] pRefData

Puntero a una estructura de FUSION_INSTALL_REFERENCE que describe la aplicación que contiene la referencia al ensamblado que se va a quitar. Si este valor es NULL, no se deja ninguna referencia al ensamblado por las aplicaciones en el almacén en paralelo y se quitan los archivos del ensamblado.

Nota Los caracteres \, /, :, ;, *, <, >y | no son válidos en el identificador de referencia.

[out, optional] pulDisposition

Puntero a un valor entero que describe la acción realizada.

El parámetro pulDisposition puede contener uno de los valores siguientes o null.

Value	Significado
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED	Los archivos de ensamblado se han quitado del almacén en paralelo.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE	Los archivos del ensamblado no se han quitado porque una aplicación usa el ensamblado .
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED	El ensamblado no existe en el almacén en paralelo.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING	Reservado.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES	Los archivos del ensamblado no se han quitado porque el almacén en paralelo contiene una referencia al ensamblado por otra aplicación.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND	La referencia especificada en pRefData no existe en el almacén en paralelo.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor devuelto	Descripción
S_OK	Los archivos del ensamblado se han quitado del almacén en paralelo.
S_FALSE	La operación se realizó correctamente y se quitó la referencia al ensamblado. Los archivos de ensamblado no se quitaron del almacén en paralelo por el motivo descrito por el valor devuelto por pulDisposition.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winsxs.h
Archivo DLL	Sxs.dll

Consulte también

IAssemblyCache

Share via