Função MsiGetShortcutTargetA (msi.h)

Artigo
11/20/2024

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. Esse 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. Esse 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. Esse parâmetro pode ser nulo.

Valor de retorno

Essa função retorna UINT.

Observações

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 poderá ser determinado usando as funções de seleção do instalador de .

Nota

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

Compartilhar via