Função MsiGetShortcutTargetA (msi.h)

A função MsiGetShortcutTarget examina um atalho e retorna seu produto, nome do recurso e componente, se disponível.

Sintaxe

UINT MsiGetShortcutTargetA(
  [in]  LPCSTR szShortcutPath,
  [out] LPSTR  szProductCode,
  [out] LPSTR  szFeatureId,
  [out] LPSTR  szComponentCode
);

Parâmetros

[in] szShortcutPath

Uma cadeia de caracteres terminada em nulo especificando o caminho completo para um atalho.

[out] szProductCode

Um GUID para o código do produto do atalho. Esse buffer de cadeia de caracteres deve ter 39 caracteres. Os primeiros 38 caracteres são para o GUID e o último caractere é para o caractere nulo de terminação. Este parâmetro pode ser nulo.

[out] szFeatureId

O nome do recurso do atalho. O buffer de cadeia de caracteres deve ter MAX_FEATURE_CHARS+1 caracteres de comprimento. Este parâmetro pode ser nulo.

[out] szComponentCode

Um GUID do código do componente. Esse buffer de cadeia de caracteres deve ter 39 caracteres. Os primeiros 38 caracteres são para o GUID e o último caractere é para o caractere nulo de terminação. Este parâmetro pode ser nulo.

Valor retornado

Essa função retorna UINT.

Comentários

Se a função falhar e o atalho existir, o conteúdo regular do atalho poderá ser acessado por meio da interface IShellLink .

Caso contrário, o estado do destino pode ser determinado usando as funções de seleção do instalador.

Observação

O cabeçalho msi.h define MsiGetShortcutTarget como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino	Windows
Cabeçalho	msi.h
Biblioteca	Msi.lib
DLL	Msi.dll