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

Artigo
03/04/2024

O método InstallAssembly adiciona uma referência de aplicativo a um assembly ao repositório lado a lado e copia os arquivos do assembly para o repositório lado a lado. Os arquivos do assembly que está sendo instalado devem estar presentes no sistema de arquivos atual.

Sintaxe

HRESULT InstallAssembly(
  [in]           DWORD                       dwFlags,
  [in]           LPCWSTR                     pszManifestFilePath,
  [in, optional] LPCFUSION_INSTALL_REFERENCE pRefData
);

Parâmetros

[in] dwFlags

Esse parâmetro especifica como os arquivos existentes no repositório lado a lado devem ser substituídos por arquivos no assembly que está sendo instalado.

Uma das opções a seguir pode ser especificada.

Valor	Significado
IASSEMBLYCACHE_INSTALL_FLAG_REFRESH	Substitua os arquivos existentes no repositório lado a lado pelos arquivos no assembly que estão sendo instalados se a versão do arquivo no assembly for maior ou igual à versão do arquivo existente.
IASSEMBLYCACHE_INSTALL_FLAG_FORCE_REFRESH	Substitua os arquivos existentes no repositório lado a lado pelos arquivos no assembly que está sendo instalado.

[in] pszManifestFilePath

Um ponteiro para um valor de cadeia de caracteres que contém o caminho completo para o arquivo DLL (biblioteca vinculada dinâmica) ou executável (EXE) que contém o manifesto do assembly. Quaisquer outros arquivos de assembly devem estar localizados no mesmo diretório que essa DLL ou EXE.

[in, optional] pRefData

Um ponteiro para uma estrutura FUSION_INSTALL_REFERENCE que descreve o aplicativo que contém a referência ao assembly que está sendo instalado. Se esse parâmetro for nulo, os arquivos de assembly serão copiados, mas nenhuma referência de aplicativo será adicionada ao repositório lado a lado.

Retornar valor

Esse método pode retornar um desses valores.

Valor retornado	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método não foi bem-sucedido.

Requisitos

Requisito	Valor
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