Função MsiSourceListAddMediaDiskA (msi.h)
A função MsiSourceListAddMediaDisk adiciona ou atualiza um disco da fonte de mídia de um produto ou patch registrado. Se o disco especificado já existir, ele será atualizado com os novos valores. Se o disco especificado não existir, uma nova entrada de disco será criada com os novos valores.
Sintaxe
UINT MsiSourceListAddMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCSTR szVolumeLabel,
[in, optional] LPCSTR szDiskPrompt
);
Parâmetros
[in] szProductCodeOrPatchCode
O ProductCode ou o GUID de patch do produto ou patch. Use uma cadeia de caracteres terminada em nulo. Se a cadeia de caracteres tiver mais de 39 caracteres, a função falhará e retornará ERROR_INVALID_PARAMETER. Esse parâmetro não pode ser NULL.
[in, optional] szUserSid
Esse parâmetro pode ser um SID de cadeia de caracteres que especifica a conta de usuário que contém o produto ou patch. O SID não é validado ou resolvido. Um SID incorreto pode retornar ERROR_UNKNOWN_PRODUCT ou ERROR_UNKNOWN_PATCH.
[in] dwContext
Esse parâmetro especifica o contexto da instância do produto ou patch. Esse parâmetro pode conter um dos valores a seguir.
[in] dwOptions
O valor
| Bandeira | Significado |
|---|---|
|
szProductCodeOrPatchCode é um GUID de código do produto. |
|
szProductCodeOrPatchCode é um GUID de código de patch. |
[in] dwDiskId
Esse parâmetro fornece a ID do disco que está sendo adicionado ou atualizado.
[in] szVolumeLabel
O szVolumeLabel fornece o rótulo do disco que está sendo adicionado ou atualizado. Uma atualização substitui o rótulo de volume existente no registro. Para alterar somente o prompt de disco, obtenha o rótulo de volume existente do registro e forneça-o nesta chamada juntamente com o novo prompt de disco. Passar uma NULL ou uma cadeia de caracteres vazia para szVolumeLabel registra uma cadeia de caracteres vazia (0 bytes de comprimento) como o rótulo de volume.
[in, optional] szDiskPrompt
Na entrada para MsiSourceListAddMediaDisk, szDiskPrompt fornece o prompt de disco do disco que está sendo adicionado ou atualizado. Uma atualização substitui o prompt de disco registrado.
Para alterar apenas o rótulo de volume, obtenha o prompt de disco existente que está registrado e forneça-o ao chamar MsiSourceListAddMediaDisk junto com o novo rótulo de volume. Passar NULL ou uma cadeia de caracteres vazia registra uma cadeia de caracteres vazia (0 bytes de comprimento) como o prompt de disco.
Valor de retorno
A função MsiSourceListAddMediaDisk retorna os valores a seguir.
| Valor | Significado |
|---|---|
|
O usuário não tem a capacidade de ler a fonte de mídia especificada ou o produto ou patch especificado. Isso não indica se uma fonte de mídia, produto ou patch foi encontrado. |
|
Os dados de configuração estão corrompidos. |
|
Não foi possível acessar o serviço Windows Installer. |
|
Um parâmetro inválido foi passado para a função. |
|
O valor foi reordenado com êxito. |
|
O patch não foi encontrado. |
|
O produto não foi encontrado. |
|
Falha interna inesperada. |
Observações
Os administradores podem modificar a instalação de uma instância de patch ou produto que existe no contexto do computador ou em seu próprio contexto por usuário (gerenciado ou não gerenciado).) Eles podem modificar a instalação de uma instância de patch ou produto que existe no contexto por usuário gerenciado por usuário. Os administradores não podem modificar a instalação de outro usuário de um produto ou instância de patch que existe no contexto não gerenciado por usuário de outro usuário.
Os não administradores não podem modificar a instalação de uma instância de patch ou produto existente no contexto por usuário de outro usuário (gerenciado ou não gerenciado).) Eles podem modificar a instalação de uma instância de patch ou produto que existe em seu próprio contexto não gerenciado por usuário. Eles podem modificar a instalação de uma instância de patch ou produto no contexto do computador ou em seu próprio contexto gerenciado por usuário somente se estiverem habilitados para procurar uma fonte de patch ou produto. Os usuários podem ser habilitados para procurar fontes definindo a política. Para obter mais informações, consulte DisableBrowse, AllowLockdownBrowse, AllowLockDownMedia e políticas de AlwaysInstallElevated.
Nota
O cabeçalho msi.h define MsiSourceListAddMediaDisk como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer 3.0 ou posterior no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
| da Plataforma de Destino |
Windows |
| cabeçalho | msi.h |
| biblioteca | Msi.lib |
| de DLL |
Msi.dll |
Consulte também
sem suporte no Windows Installer 2.0 e anteriores